From owner-freebsd-doc Tue Jan 29 20:42: 6 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 BD66E37B402 for ; Tue, 29 Jan 2002 20:42:02 -0800 (PST) Received: by mail1.zer0.org (Postfix, from userid 1001) id 7B759239A05; Tue, 29 Jan 2002 20:42:02 -0800 (PST) Date: Tue, 29 Jan 2002 20:42:02 -0800 From: Gregory Sutter To: "Gary W. Swearingen" Cc: doc@FreeBSD.ORG Subject: Re: Practicalities of FAQ->Handbook migrations Message-ID: <20020130044202.GX5234@klapaucius.zer0.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: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="5T9d2Bf7JajBsgKp" Content-Disposition: inline In-Reply-To: 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 --5T9d2Bf7JajBsgKp Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2002-01-27 18:03 -0800, "Gary W. Swearingen" wrote: > Gregory Sutter writes: >=20 > > 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 > I have thought that the best way to handle such a massive and > maintenance-intensive project, would be to have a Wiki > (http://c2.com/cgi-bin/wiki) for it. Let users add and fix links as > they will (subject to a team of monitors, mainly to back out vandalism). > But that would be a large project in itself and there are legal risks. Wikis are useful for small groups, but they don't scale well to large efforts. In addition, for a group that is accustomed to DocBook and CVS, a Wiki is a good dozen steps backward. Wikis can't be automanglically changed into PDF, PS, text, or half a dozen other formats; their change-control mechanisms are too simple; they can't be locally edited by multiple developers; and it's yet another=20 markup language to learn, albeit a (too) simplistic one. I'm not totally dissing WikiWikiWebs; they have their place. I use several of them on a regular basis. But I don't think it's the=20 proper tool for this job. Greg --=20 Gregory S. Sutter Build a man a fire, and he'll be warm mailto:gsutter@zer0.org for a day. Set a man on fire, and he'll http://www.zer0.org/~gsutter/ be warm for the rest of his life.=20 hkp://wwwkeys.pgp.net/0x845DFEDD --5T9d2Bf7JajBsgKp Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Comment: '' iD8DBQE8V3maIBUx1YRd/t0RAlHQAJ4v3zSKePi7DnLdusl8CzPycMz4fgCeLa4u ebbF4qfn+dHuB0hErRPSOUM= =aO2o -----END PGP SIGNATURE----- --5T9d2Bf7JajBsgKp-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message