From owner-freebsd-doc@FreeBSD.ORG Fri Oct 7 05:17:48 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 6A22816A41F for ; Fri, 7 Oct 2005 05:17:48 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from kane.otenet.gr (kane.otenet.gr [195.170.0.95]) by mx1.FreeBSD.org (Postfix) with ESMTP id AF8F243D46 for ; Fri, 7 Oct 2005 05:17:46 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from flame.pc (patr530-a060.otenet.gr [212.205.215.60]) by kane.otenet.gr (8.13.4/8.13.4/Debian-1) with ESMTP id j975HgVH021091; Fri, 7 Oct 2005 08:17:43 +0300 Received: from flame.pc (flame [127.0.0.1]) by flame.pc (8.13.4/8.13.4) with ESMTP id j975Ghfb001988; Fri, 7 Oct 2005 08:16:43 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by flame.pc (8.13.4/8.13.4/Submit) id j975GgU8001987; Fri, 7 Oct 2005 08:16:42 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Fri, 7 Oct 2005 08:16:42 +0300 From: Giorgos Keramidas To: Mark Linimon Message-ID: <20051007051642.GA1942@flame.pc> 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> <20051007032725.GA8068@soaustin.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20051007032725.GA8068@soaustin.net> Cc: freebsd-doc@freebsd.org Subject: Re: FreeBSD documentation format [was: 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 05:17:48 -0000 On 2005-10-06 22:27, Mark Linimon wrote: >On Thu, Oct 06, 2005 at 07:22:55PM -0700, Gary W. Swearingen wrote: >> 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. > > I hope to God that we never do this. I may be a minority of > one, but I find wiki markup language to be the worst > abomination foisted off on computer users since Windows NT 1.0. > I can _not_ work on editing wiki data for more than about 10 > minutes before I simply cannot stand it any more and walk away. Ditto. I have grown quite allergic to wikis too for any amount of serious work lately. The general idea of a wiki is something I like a lot. The little details of how and where spaces or other special wiki-characters have to be put to get a consistent *and* nice look and feel is always what gets me after about 1-2 minutes. The fact that hare writing in undersized web form windows that work in their own special, quite unfathomable ways, quite unlike vim, emacs or any other text editor I've learned to like so far, is another factor for my wiki-allergy :)