victronenergy / victron-press

Based on vuepress - this a set of tools to maintain and publish documentation using md as a source format
1 stars 1 forks source link

Site looks strange on widescreen displays #14

Open Wholistic opened 5 years ago

Wholistic commented 5 years ago

Screen Shot 2019-06-09 at 12 14 30 am

Thats a lot of white space.

Screen res is 2560 wide, the content panel maxes out at 700 pixels wide.

DvdGiessen commented 5 years ago

The content in VictronPress is limited to a width of 740 pixels. The limit is by design, as a too wide content area generally becomes harder to read.

Studies usually suggest a width between 500 and 900 pixels is optimal for most cases, depending on multiple factors such as the exact type of reading (quickly scanning the contents vs accurately reading the text), the comprehensibility of the text (a children's book text vs a complex academical paper text), legibility of the chosen font, colour contrast, the physical screen it is displayed on, perceived smoothness of scrolling, and different personal preferences between people.

Not every site does it, but it is considered good practise to limit the width of the content area like we do.

@lasselicht What are you thoughts on this?

For comparison, a few other well-known websites showcasing similar content width limits:

News sites: The New York Times (600px): afbeelding

BBC (590px): afbeelding

NOS (640px): afbeelding

Wired (530px): afbeelding

Technical documentation sites: Apple's documentation for the Swift language (735px): afbeelding

Google Cloud documentation (850px): afbeelding

Facebook's API documentation (800px): afbeelding

GitHub's API documentation (640px): afbeelding

Or even this issue page itself (660px): afbeelding

Wholistic commented 5 years ago

Notice in those other examples that the navigation elements are aligned with the text area.

In our site, the navigation is ALLLL the way over to the left.

Google's looking pretty good at 850 in my opinion.

lasselicht commented 5 years ago

Hi @Wholistic, great list of examples! Research shows that 12 words on 1 line are easiest to read, we are already over that number. Other then that I don't believe many people that use high resolution displays use them at full screen but more in windowed mode. We can get that information from analytics as soon as we will add analytics which is currently not in the scope of any release. For now won't fix.