raphinesse commented on issue #837: Update docs design to improve readability
URL: https://github.com/apache/cordova-docs/pull/837#issuecomment-399947669
 
 
   I like what you did there! :+1:
   
   But as you'd probably expect from me by now, I still have a few suggestions 
:wink: 
   If we're doing this, I would like to further increase the body type size and 
further reduce the line length. [Butterick recommends 45-90 characters per 
line](https://practicaltypography.com/line-length.html). Thus middle ground 
would be around 68 letters. So the first line could be these 70 characters:
   
   > This guide shows how to set up your SDK environment to deploy Cordova 
   
   I got to the above line length with 18px font size in a 800px container. 
800px gets a bit slim for the code samples though, even with the smaller font 
size that is used there. We should really target 80-120 characters here too, 
but that's not so easy to change now :smirk:
   So from playing around I think 18px body type in a 960px container look 
reasonable for the main text and the code samples. And it's barely in the 
recommended range with about 90 characters per line.
   
   Any opinions on this?

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to