Date: 30 Jan 2002 11:49:24 -0800 From: swear@blarg.net (Gary W. Swearingen) To: Gregory Sutter <gsutter@zer0.org> Cc: doc@FreeBSD.ORG Subject: Re: Practicalities of FAQ->Handbook migrations Message-ID: <zrd6zrliuz.6zr@localhost.localdomain> In-Reply-To: <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> <q37kq3nsea.kq3@localhost.localdomain> <20020130044202.GX5234@klapaucius.zer0.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Gregory Sutter <gsutter@zer0.org> writes: > > > 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. ... > 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 > 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 > proper tool for this job. "This job", being what? A paper (and other format) index? That may be too ambitious (too consuming of FDP resources). I see the wiki link index as be maintained by non-FDP people (except for the infrastructure) with no need to be transformed to other formats. As to the scaling, what problems do you see effecting a FreeBSD Wiki? It's more debatable whether such Wiki should allow more than links (with brief descriptions), because then there'd be lots of duplication with DocBook stuff, and maybe find that people were much more willing to help with near-plain text docs than the DocBook stuff which I'm sure discourages most potential helpers. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?zrd6zrliuz.6zr>