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

Nik Clayton nik at freebsd.org
Thu Jun 12 01:33:50 PDT 2003


On Wed, Jun 11, 2003 at 09:50:20AM -0400, Michael W . Lucas wrote:
> 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.

I have a cunning plan, for which I currently have no time.  It goes like
this:

Put a Q&A section at the end of every chapter in the Handbook (like the
existing 2.11.4, but considerably expanded).

As long as this section is appropriately marked up, we can then
automatically generate the separate FAQ from its contents.  We can then
produce three documents:

    Handbook with integrated FAQ, one volume

    Handbook, no FAQ, one volume

    FAQ, one volume

N
-- 
FreeBSD: The Power to Serve      http://www.freebsd.org/               (__)
FreeBSD Documentation Project    http://www.freebsd.org/docproj/    \\\'',)
                                                                      \/  \ ^
   --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---         .\._/_)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-doc/attachments/20030612/dcb7d075/attachment.bin


More information about the cvs-doc mailing list