From owner-freebsd-doc Tue Jan 29 20:48:19 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 8069037B402; Tue, 29 Jan 2002 20:48:15 -0800 (PST) Received: by mail1.zer0.org (Postfix, from userid 1001) id 559F4239A05; Tue, 29 Jan 2002 20:48:15 -0800 (PST) Date: Tue, 29 Jan 2002 20:48:15 -0800 From: Gregory Sutter To: Michael Lucas Cc: Nik Clayton , doc@FreeBSD.ORG Subject: Re: Practicalities of FAQ->Handbook migrations Message-ID: <20020130044815.GY5234@klapaucius.zer0.org> References: <20020121140800.A54903@blackhelicopters.org> <20020121215313.K18715@clan.nothing-going-on.org> <20020121174711.A56388@blackhelicopters.org> <20020127115139.GU5234@klapaucius.zer0.org> <20020128050724.B93827@blackhelicopters.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="8VKnE9k7k7imdYv5" Content-Disposition: inline In-Reply-To: <20020128050724.B93827@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 --8VKnE9k7k7imdYv5 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2002-01-28 05:07 -0500, Michael Lucas wro= te: > On Sun, Jan 27, 2002 at 03:51:39AM -0800, Gregory Sutter wrote: > > > > 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. > >=20 > > 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? >=20 > Something like that, yes. I would say we should only link to our own > documents, for reasons pointed out elsewhere in this thread. Although > I have a vested interest in onlamp.com, I don't want to maintain an > index linking to them, BSDzine, daemonnews, etc, etc, etc. So you're saying that you don't want to be ? By the way, only partially blame me for the content there. DMOZ is _barely_ an "Open" directory, as the editorial rules are draconian. In fact, I've once again lost my editor bit, because I didn't make an edit in 60 days... I don't think I'll ask for it back this time. > Once we gain experience in indexing our own docs, we could expand it > to other sites, but let's start small. :) Once we do that we'd need > some infrastructure to automatically notice and find bad links, for Link checkers are available in the ports collection. Starting small (local docs) is a good idea. Greg --=20 Gregory S. Sutter Only two things are infinite, the mailto:gsutter@zer0.org universe and human stupidity, and I'm http://www.zer0.org/~gsutter/ not sure about the former. hkp://wwwkeys.pgp.net/0x845DFEDD - Albert Einstein --8VKnE9k7k7imdYv5 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Comment: '' iD8DBQE8V3sPIBUx1YRd/t0RAmexAJ4yfu9+g0rseAvK9pnP8VxLF3z4NgCaAxIt 1TJO7A8TUf8HmBEQKaPebSc= =rIM3 -----END PGP SIGNATURE----- --8VKnE9k7k7imdYv5-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message