Re: [gentoo-doc] Organization of documentation on gentoo.org

[Jose Luis Rivero]

Hi Craig:

On Fri, Jan 18, 2008 at 04:40:24PM -0800, Craig Finch wrote:
> This is really confusing, and even after years of using Gentoo, I still have to hunt around to find out where to look.  I propose to remove "About Gentoo", "Philosophy", and "Social Contract" from the Documentation heading, because they don't fit with everything else that we call docs.  I propose to replace all of the above with the following simple structure:
>
> Documentation:
> ----------------
> Overview
> Gentoo Handbook
> Documentation Listing
>
> About:
>
> ----------------
> About Gentoo
>
> Philosophy
>
> Social Contract
>
> "Overview" links to the page http://www.gentoo.org/doc/en/index.xml
> "Gentoo Handbook" stays the same
> "Documentation Listing" stays the same
>

I agree with you in this new layout but I would like to make some
considerations to your idea:

> The page "Installation Docs" is unnecessary--the paragraphs at the top are duplicates of the text on the "documentation home" page, and the links below are unneeded because the "Documentation Listing" has the installation docs conveniently grouped at the top of the list.

"Installation Docs" is (talking about xml source) the same page as
"documentation home" (index.xml) this is the reason why you see the same
(but not duplicated) text. 

I really like the "Installation Docs" page, which gives the user a quick
overview about the diferents levels and options we offer to install
Gentoo and not only the well-known handbook.  The quick-guides for non
new users, the lot of times forgotten networless handbook and some more
advanced or exotic options like raid+lvm, bsd or alternative
installation guide.

I'm for keeping this link but I'm also for keeping the number of documentation
main page links in three so .. my vote goes to change handbook direct
link to this one. We would keep the handbook as the main option since is
the first link in this page.

Another good option to me is to use the documentation listing in full
mode (list.xml?desc=1) which gives a more elaborated image (and provides
extra information) than lots of categorized links with no further description.

Thanks.

-- 
Jose Luis Rivero <yoswink@g.o>
Gentoo/Doc Gentoo/Alpha

-- 
gentoo-doc@l.g.o mailing list