On 28 March 2012 08:15, Sven Vermeulen <sw...@gentoo.org> wrote: >> Then again, Gentoo is about choice. It just seems like we're >> presenting users with more choices than makes sense for a newbie. If >> there is a choice between something that 99.99% of users will want, >> and some ancient piece of cruft that still works and is better for >> 0.01% of the userbase, does that really have to be in the handbook? > > Welcome to documentation development. The Gentoo Handbook has always been a > difficult source for such discussions. If we truely want to provide > information towards our users on all possible choices, you'll need a totally > different approach. > > I once started (before I left Gentoo, rejoined, left again) on a "complete > gentoo handbook" that covered much more in greater detail (you'll find the > last version at > http://www.gentoo.org/doc/en/handbook/draft/complete/handbook.xml) but I've > since moved away from that. Perhaps I should work again on it... > > Wkr, > Sven Vermeulen >
An idea is a javascripty-dynamic-slidey thing that makes more details and advanced stuff visible to people who want it, so you can adjust the documentation to suit your skill level. -- Kent perl -e "print substr( \"edrgmaM SPA NOcomil.ic\\@tfrken\", \$_ * 3, 3 ) for ( 9,8,0,7,1,6,5,4,3,2 );"
