Date: Thu, 12 Jun 2003 09:33:21 +0100 From: Nik Clayton <nik@freebsd.org> To: "Michael W . Lucas" <mwlucas@blackhelicopters.org> Cc: cvs-all@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml Message-ID: <20030612083321.GB19458@clan.nothing-going-on.org> In-Reply-To: <20030611095020.B19916@blackhelicopters.org> References: <200306110036.h5B0aOkL049132@repoman.freebsd.org> <20030611083344.GA35406@HAL9000.homeunix.com> <20030611095020.B19916@blackhelicopters.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--qcHopEYAB45HaUaB
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
On Wed, Jun 11, 2003 at 09:50:20AM -0400, Michael W . Lucas wrote:
> Short answer:
>=20
> 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.
>=20
> 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
--=20
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 --- .\._/=
_)
--qcHopEYAB45HaUaB
Content-Type: application/pgp-signature
Content-Disposition: inline
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)
iD8DBQE+6DrRk6gHZCw343URAmFhAJkBhnbVWu5/Y4o5qbTySY/UpoGDWgCdH2bB
a/v2tnRh0uxygv107ODg1T4=
=S6NH
-----END PGP SIGNATURE-----
--qcHopEYAB45HaUaB--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030612083321.GB19458>