From owner-freebsd-chat@FreeBSD.ORG Thu Jan 8 17:09:34 2004 Return-Path: Delivered-To: freebsd-chat@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A953B16A4CE for ; Thu, 8 Jan 2004 17:09:34 -0800 (PST) Received: from rwcrmhc13.comcast.net (rwcrmhc13.comcast.net [204.127.198.39]) by mx1.FreeBSD.org (Postfix) with ESMTP id 20BD943D2F for ; Thu, 8 Jan 2004 17:09:32 -0800 (PST) (envelope-from underway@comcast.net) Received: from localhost.localdomain (12-230-74-101.client.attbi.com[12.230.74.101]) by comcast.net (rwcrmhc13) with ESMTP id <2004010901093101500bal59e>; Fri, 9 Jan 2004 01:09:31 +0000 Received: from localhost.localdomain (localhost [127.0.0.1]) i0917oYS019048; Thu, 8 Jan 2004 17:07:50 -0800 (PST) (envelope-from underway@comcast.net) Received: (from jojo@localhost) by localhost.localdomain (8.12.10/8.12.10/Submit) id i0917iJv019047; Thu, 8 Jan 2004 17:07:44 -0800 (PST) (envelope-from underway@comcast.net) To: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=) References: <6.0.1.1.1.20040106204233.04436d28@imap.sfu.ca> <20040107001258.GA742@arthur.nitro.dk> From: underway@comcast.net (Gary W. Swearingen) Date: Thu, 08 Jan 2004 17:07:44 -0800 In-Reply-To: ( =?iso-8859-1?q?Dag-Erling_Sm=F8rgrav's_message_of?= "Thu, 08 Jan 2004 18:40:42 +0100") Message-ID: User-Agent: Gnus/5.1002 (Gnus v5.10.2) XEmacs/21.4 (Portable Code, berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit cc: freebsd-chat@FreeBSD.org Subject: Re: Where is FreeBSD going? X-BeenThere: freebsd-chat@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Non technical items related to the community List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 09 Jan 2004 01:09:34 -0000 des@des.no (Dag-Erling Smørgrav) writes: > Anyone who is reasonably familiar with HTML can learn enough DocBook > to contribute to the FDP in a matter of minutes. It's not even that hard, as they may submit plain text or even just a report of the problem. But unless you're contributing some important missing content, whatever you contribute will be met with requests to do better, and you'll feel embarassed about leaving others to do your grunt work. Or you'll tire of getting someone to do it as you wanted it, or at all. Even if you know or learn DocBook and the FDP primer, you'll be grieved by silly things like deleting spaces where you shouldn't have, or using the "xyz" manpage entity instead of the "xyz" command entity. The system obviously works; I'm just saying what seems undeniable: that a simpler source language would draw more contributions, and what is just my opinion: that a simpler wiki-like language with only a handful of lanugage elements would make for better documentation because it would have better content, at the small cost of being a little uglier and harder for someone to sell in book form.