Skip to content

Grow our font size and set the content width to have ~80 characters #427

@choldgraf

Description

@choldgraf

In the sphinx book theme I was doing a bit of research on good practices for design around web content for readability and accessibility. One thing that I consistently ran into was that you should shoot for 45-75 characters per line, with a max of 80 characters. (though note that Wikipedia seemed to think that a longer width was OK for material that needs to be information dense and "scannable"). They also consistently recommended 16px as the font base size.

Currently, our base font size is 15px, and the max width allows for about 108 characters per line on my screen.

What do people think about these two changes to this theme:

  • Set the font base size to 16px to be a bit larger. Here's one ref that recommends this.
  • Set the main content max-width such that, at a 16px font size, we have ~90 characters per line. (this is more than the recommended line width, but IMO this is OK since documentation content may have the same "scannability" needs that wikipedia does...I am happy to hear countering opinions on this one!).

What do folks think about this? (cc also @bollwyvl whose perspective on accessibility I have appreciated!)

Some refs:

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs: discussionNeeds discussion before an implementation can be made

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions