[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Basic documentation style for better reading



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 to: