cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml

[Michael W . Lucas]

On Wed, Jun 11, 2003 at 01:33:44AM -0700, David Schultz wrote:
> On Tue, Jun 10, 2003, Michael Lucas wrote:
> > mwlucas     2003/06/10 17:36:24 PDT
> > 
> >   FreeBSD doc repository
> > 
> >   Modified files:
> >     en_US.ISO8859-1/books/faq book.sgml 
> >   Log:
> >   Any FAQ that begins with "I just upgraded to 2.0.5" deserves to be
> >   exterminated with extraordinary prejudice.
> 
> Thank you!  I'm glad someone finally took the initiative to clean
> the cruft from our FAQ!

You're welcome.

>  (I would have suggested that we move the
> useful information to the Handbook and eliminate the FAQ.)

You and many other people.  There's much discussion about this in the
archives.

Short answer:

The FAQ and the Handbook have different goals.  The FAQ is supposed to
be brief and q&a oriented.  Instead, it's full of brief tutorials that
need to be integrated into the Handbook.

Stuff like "why did I upgrade to -stable and get -rc?" belongs in the
FAQ.

==ml

-- 
Michael Lucas		mwlucas at FreeBSD.org, mwlucas at BlackHelicopters.org
http://www.BlackHelicopters.org/~mwlucas/

           Absolute OpenBSD:   http://www.AbsoluteOpenBSD.com/