Re: Basic documentation style for better reading
Oh, well, I was reading documentation on packaging and I saw 2 types of pages. Like this one:
That has none styles set, and like this one http://www.debian.org/doc/debian-policy/ch-scope.html that has margin: 5px set on body.
About wideness of your screen -- it doesn't matter how wide your screen is. I don't know what is the golden standard, quick search work showed, for example, this http://webtypography.net/Rhythm_and_Proportion/Horizontal_Motion/2.1.2/ -- I'm OK if you choose something different from 800px, but the main idea is that current width is too much for comfortable reading and it should never exceed 800px (or whatever).
I don't think there's an industry standard for this, or it's being hidden somewhere. When I was choosing a comfortable reading width for my blog that has code-samples, I chose 800px and I love it. I find it as a good balance between comfort reading and providing some code samples. Example -- http://www.redhotchilipython.com/posts/2011-06-17-safe-html-wysiwyg.html
Right now I use firebug to set that style while reading debian docs and I can say that it's really so much better now.
(old - http://dl.dropbox.com/u/865508/deb_1.png ,
new - http://dl.dropbox.com/u/865508/deb_2.png )
On Sun, Mar 11, 2012 at 3:43 AM, Osamu Aoki <email@example.com>
Please be specific which one. As I see:
On Sun, Mar 11, 2012 at 02:12:50AM +0200, Kostya Rybnikov wrote:
> I'm trying to get started and read HTML docs and what I can say that it is
> hard to read in it's current view.
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Why 800px? Cell phone may be narrower and my desktop is wider.
> So I suggest to improve reading process
> by adding small change on HTML generation: add style="max-width: 800px;
> margin: 0pt auto;" inside body tag. That would make a huge difference.
What is the reference style guide which support your preference?
Without proper justification, I do not think we have any reason to change.
Is this some well established industry standard? I have no idea.