From owner-freebsd-doc@FreeBSD.ORG Fri Oct 7 02:19:30 2005 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5D04B16A41F for ; Fri, 7 Oct 2005 02:19:30 +0000 (GMT) (envelope-from garys@opusnet.com) Received: from opusnet.com (mail.opusnet.com [209.210.200.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0097D43D46 for ; Fri, 7 Oct 2005 02:19:29 +0000 (GMT) (envelope-from garys@opusnet.com) Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP (SMTPD32-8.05) id AB2B512A0108; Thu, 06 Oct 2005 19:19:23 -0700 Received: from localhost.localhost (localhost.localhost [127.0.0.1]) by localhost.localhost (8.13.3/8.13.3) with ESMTP id j972N5tG022956; Thu, 6 Oct 2005 19:23:05 -0700 (PDT) (envelope-from garys@opusnet.com) Received: (from jojo@localhost) by localhost.localhost (8.13.3/8.13.3/Submit) id j972Mt40022955; Thu, 6 Oct 2005 19:22:55 -0700 (PDT) (envelope-from garys@opusnet.com) To: linimon@lonesome.com (Mark Linimon) 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> From: garys@opusnet.com (Gary W. Swearingen) Date: Thu, 06 Oct 2005 19:22:55 -0700 In-Reply-To: <20051006203845.GA28371@soaustin.net> (Mark Linimon's message of "Thu, 6 Oct 2005 15:38:45 -0500") Message-ID: User-Agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.4.17 (Jumbo Shrimp, berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: Lowell Gilbert , freebsd-doc@freebsd.org Subject: Re: FAQ Updates X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 Oct 2005 02:19:30 -0000 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.