On Mon, Aug 30, 2004 at 01:10:23PM -0400, Brian Connelly wrote:
Perhaps using a #4-esque guide with a nice, detailed bootstrapping section like those in #3 would be nice-- the reader would get a nice set of instructions to follow when installing the system as well as more information for later.
Based on all input and the fact that it's not mutually exclusive, I'd say the best is to write a full explanation with a chapter containing step-by-step instructions :)
I'll keep this in mind. Thanks for the input!
Wkr, Sven Vermeulen
/me agrees
#1 and #2 would be too difficult both for us and for users.
Integrating all possibilities into the HB is overkill, let's keep it simple (cough cough) enough, just like our partition scheme even though we know many users will partition differently.
Add-on guides (not errata) like the LVM2 are better IMO.
#3 or #4, or both, or a mix are OK. It all depends on who writes about what subject for what audience.
A step-by-step is usually what users want first, like the handbook or the LVM2 guide. A more detailed explanation is often useful.
I have seen so many docs explain much about the how-it-works and completely overlook the how-do-I-use-it.
FWIW, 2 things made me choose Gentoo (1.4rc1 at the time): f.g.o and the docs, mainly the install doc (11 pages!) that I could read top to bottom _while_ installing. Our HB has become much larger but still achieves the same result.
There's no need to read plenty and learn a lot before you start doing anything.
With Gentoo, it's intall, learn next and then build your knowledge using it as opposed to learn a lot and try to install later, or click-click-click and hope it works.
Cheers, -- / Xavier Neys \_ Gentoo Documentation Project / French & Internationalisation Lead \ http://www.gentoo.org/doc/en /\
signature.asc
Description: OpenPGP digital signature
