On Wed, Mar 28, 2012 at 08:20:45AM +1300, Kent Fredric wrote: > 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.
Why not just the separate "quick install" guide like we have that lists steps and the handbook if yu want more details? William
pgpqE8WTjvLWn.pgp
Description: PGP signature
