From owner-freebsd-doc Sun Jan 27 3:51:47 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mail1.zer0.org (klapaucius.zer0.org [204.152.186.45]) by hub.freebsd.org (Postfix) with ESMTP id B183B37B400; Sun, 27 Jan 2002 03:51:39 -0800 (PST) Received: by mail1.zer0.org (Postfix, from userid 1001) id 7D4D6239A06; Sun, 27 Jan 2002 03:51:39 -0800 (PST) Date: Sun, 27 Jan 2002 03:51:39 -0800 From: Gregory Sutter To: Michael Lucas Cc: Nik Clayton , doc@freebsd.org Subject: Re: Practicalities of FAQ->Handbook migrations Message-ID: <20020127115139.GU5234@klapaucius.zer0.org> References: <20020121140800.A54903@blackhelicopters.org> <20020121215313.K18715@clan.nothing-going-on.org> <20020121174711.A56388@blackhelicopters.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="nNx5P6V1TPcCvZS+" Content-Disposition: inline In-Reply-To: <20020121174711.A56388@blackhelicopters.org> User-Agent: Mutt/1.3.25i Organization: Zer0 X-Purpose: For great justice! Mail-Copies-To: poster Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --nNx5P6V1TPcCvZS+ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2002-01-21 17:47 -0500, Michael Lucas wro= te: > On Mon, Jan 21, 2002 at 09:53:13PM +0000, Nik Clayton wrote: > > On Mon, Jan 21, 2002 at 02:08:00PM -0500, Michael Lucas wrote: > > > I suggest that we create a Handbook section called something like > > > "Living with FreeBSD" that contains small, catch-all tutorials. > > > Thoughts? > >=20 > > Why not create a new top-level book for it? >=20 > The "Miscellaneous FreeBSD Cra^H^H^HStuff Guide?" >=20 > I suppose we could. I'd personally prefer a single book with > everything in it, but will obey the consensus of the group. Well, in Message-ID: <20020119200120.A46175@blackhelicopters.org> you talk about a document full of nothing but topics/questions and pointers to answers. It seems to me that if the answer were sufficiently concise, then it could be placed directly in that document, in addition to or in lieu of pointers to further information. I understand the need for such an index document. There is a wealth of FreeBSD information in the FAQ, Handbook, Committer's Guide, articles, books, manual pages, O'Reillynet articles, Daemon News articles, hardcopy books, graphics, ascii art, and also a few hundred web sites, some of it very difficult to find despite its potential utility to many FreeBSD users. The Documentation Project seems the logical organization to provide an index of pointers to and within these resources. Instead of "jumbo FAQ", though, perhaps the FreeBSD Documentation Index would be a better, and sufficiently pretentious, name. Is this the kind of thing you were talking about, Michael? Greg --=20 Gregory S. Sutter Heisenberg might have been here. mailto:gsutter@zer0.org=20 http://www.zer0.org/~gsutter/=20 hkp://wwwkeys.pgp.net/0x845DFEDD --nNx5P6V1TPcCvZS+ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Comment: '' iD8DBQE8U+nLIBUx1YRd/t0RAhQeAJ9PZ1xzKJ4zDNCY1SFvj6HZs4fwkACdHru+ tsNN3VFRmPf2G+BKq+2gZrg= =xQfa -----END PGP SIGNATURE----- --nNx5P6V1TPcCvZS+-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message