From owner-freebsd-doc Mon Jan 28 2: 7:29 2002 Delivered-To: freebsd-doc@freebsd.org Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id 3880037B402; Mon, 28 Jan 2002 02:07:26 -0800 (PST) Received: (from mwlucas@localhost) by blackhelicopters.org (8.11.6/8.11.6) id g0SA7OW93908; Mon, 28 Jan 2002 05:07:24 -0500 (EST) (envelope-from mwlucas) Date: Mon, 28 Jan 2002 05:07:24 -0500 From: Michael Lucas To: Gregory Sutter Cc: Nik Clayton , doc@FreeBSD.ORG Subject: Re: Practicalities of FAQ->Handbook migrations Message-ID: <20020128050724.B93827@blackhelicopters.org> References: <20020121140800.A54903@blackhelicopters.org> <20020121215313.K18715@clan.nothing-going-on.org> <20020121174711.A56388@blackhelicopters.org> <20020127115139.GU5234@klapaucius.zer0.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20020127115139.GU5234@klapaucius.zer0.org>; from gsutter@zer0.org on Sun, Jan 27, 2002 at 03:51:39AM -0800 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 On Sun, Jan 27, 2002 at 03:51:39AM -0800, Gregory Sutter wrote: > On 2002-01-21 17:47 -0500, Michael Lucas wrote: > 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? 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. 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 example. (I'm sure one of you web developers have programs sitting around to do exactly that, but we'd want to make it project process to use them on a, say, weekly basis.) I have to admit that I don't like the idea of putting answers in an index. That's not what an index is for. But the FreeBSD Documentation Index sounds sufficiently weighty. -- Michael Lucas mwlucas@FreeBSD.org, mwlucas@BlackHelicopters.org my FreeBSD column: http://www.oreillynet.com/pub/q/Big_Scary_Daemons http://www.blackhelicopters.org/~mwlucas/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message