Oh, well, I was reading documentation on packaging and I saw 2 types of
pages. Like this one:

http://www.debian.org/doc/packaging-manuals/python-policy/ch-python.html

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 )

Thanks!

On Sun, Mar 11, 2012 at 3:43 AM, Osamu Aoki <[email protected]> wrote:

> Hi,
>
> On Sun, Mar 11, 2012 at 02:12:50AM +0200, Kostya Rybnikov wrote:
> > Hi!
> >
> > 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.
>
> Please be specific which one.  As I see:
> http://www.debian.org/releases/stable/i386/
> http://www.debian.org/doc/manuals/debian-reference/
> These use
> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
> alink="#0000FF">
>
> > 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.
> >
>
> Why 800px?  Cell phone may be narrower and my desktop is wider.
>
> 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.
>
> Regards,
>
> Osamu
>

Reply via email to