Date: Thu, 06 Oct 2005 19:22:55 -0700 From: garys@opusnet.com (Gary W. Swearingen) To: linimon@lonesome.com (Mark Linimon) Cc: Lowell Gilbert <lgusenet@be-well.ilk.org>, freebsd-doc@freebsd.org Subject: Re: FAQ Updates Message-ID: <cq7jcquku8.jcq@mail.opusnet.com> In-Reply-To: <20051006203845.GA28371@soaustin.net> (Mark Linimon's message of "Thu, 6 Oct 2005 15:38:45 -0500") References: <20051006135047.B0AB91551@fury.csh.rit.edu> <20051006074516.3F3251551@fury.csh.rit.edu> <20051006080941.GD2627@soaustin.net> <20051006170801.GB20088@soaustin.net> <443bnezgbl.fsf@be-well.ilk.org> <20051006203845.GA28371@soaustin.net>
next in thread | previous in thread | raw e-mail | index | archive | help
linimon@lonesome.com (Mark Linimon) writes: > On Thu, Oct 06, 2005 at 01:49:18PM -0400, Lowell Gilbert wrote: >> I am occasionally tempted to write up a "top ten most frequently asked >> questions on freebsd-questions" list. > > Please do so! I had exactly the opposite thought. But if done, it could be a section of the FAQ's introduction chapter, just referencing ten entries in the other chapters, improving those entries as desire permits. > The problem is that the FAQ is trying to do to too many things. I'm > open to suggestions. I see two problems: 1) Some people will always want it to do all those things, and it's hard to stop them. 2) Most people don't want to maintain the stuff and it's hard to start them. There's no way to change this and it's best to just leave the unessential FAQ to those who can't be discouraged from working on it but to make a practice of marking rotten entries "BROKEN" and removing rotten entries which seem unlikely to ever be of any use to anyone. > Perhaps the technical questions really belong in a knowledge base or a > wiki or some other resource. Casting them into an SGML file is too high > a barrier of entry for a lot of people, and with that high barrier, things > do not tend to get updated, either. Amen. The FAQ would be better as part of a wiki where more people would hack on it. But that won't happen without someone willing to devote a lot of time to maintaining the server and some moderators. And if there was such a wiki, it would probably grow like Topsy, with work on Docbook docs dropping real far real fast. Maybe that's enough reason to not have a wiki. But I've long wished that the Docbook docs be ditched after using their content to seed a wiki. A small subset of HTML is sufficient markup for anybody but book publishers, IMO.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?cq7jcquku8.jcq>