From owner-cvs-doc@FreeBSD.ORG Thu Jun 12 01:33:50 2003 Return-Path: Delivered-To: cvs-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 532CE37B401; Thu, 12 Jun 2003 01:33:50 -0700 (PDT) Received: from crf-consulting.co.uk (pc-62-31-42-106-hy.blueyonder.co.uk [62.31.42.106]) by mx1.FreeBSD.org (Postfix) with ESMTP id C9B7143F85; Thu, 12 Jun 2003 01:33:47 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20]) by crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id h5C8XPRf094931; Thu, 12 Jun 2003 09:33:25 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) h5C8XPLG019539; Thu, 12 Jun 2003 09:33:25 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost) by clan.nothing-going-on.org (8.12.8/8.12.8/Submit) id h5C8XLQF019538; Thu, 12 Jun 2003 09:33:21 +0100 (BST) Date: Thu, 12 Jun 2003 09:33:21 +0100 From: Nik Clayton To: "Michael W . Lucas" Message-ID: <20030612083321.GB19458@clan.nothing-going-on.org> References: <200306110036.h5B0aOkL049132@repoman.freebsd.org> <20030611083344.GA35406@HAL9000.homeunix.com> <20030611095020.B19916@blackhelicopters.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="qcHopEYAB45HaUaB" Content-Disposition: inline In-Reply-To: <20030611095020.B19916@blackhelicopters.org> User-Agent: Mutt/1.4i Organization: FreeBSD Project cc: Michael Lucas cc: doc-committers@freebsd.org cc: cvs-doc@freebsd.org cc: cvs-all@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Jun 2003 08:33:50 -0000 --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--