From owner-freebsd-questions@FreeBSD.ORG Tue Feb 24 00:28:39 2009 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 11BE31065670 for ; Tue, 24 Feb 2009 00:28:39 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id 5839A8FC13 for ; Tue, 24 Feb 2009 00:28:38 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from kobe.laptop (adsl131-194.kln.forthnet.gr [77.49.250.194]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-6) with ESMTP id n1O0S8oD003068 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Tue, 24 Feb 2009 02:28:14 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id n1O0S60f009940 for ; Tue, 24 Feb 2009 02:28:06 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id n1O0S6lf009939; Tue, 24 Feb 2009 02:28:06 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) From: Giorgos Keramidas To: freebsd-questions@freebsd.org References: <9ef7e7380902220154t74657d52uc9497c77672b79f8@mail.gmail.com> <9a52b1190902220711u65e38320t97ca56547bef246d@mail.gmail.com> <87ljryccm0.fsf@kobe.laptop> <49a20440.oqh9j8d04xp6dYo8%perryh@pluto.rain.com> <87mycd847c.fsf@kobe.laptop> <20090223195041.GC58188@kokopelli.hydra> <20090223160951.056f54d1@scorpio> Date: Tue, 24 Feb 2009 02:28:06 +0200 In-Reply-To: <20090223160951.056f54d1@scorpio> (Jerry's message of "Mon, 23 Feb 2009 16:09:51 -0500") Message-ID: <877i3gk7ah.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.90 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Hellug-MailScanner-ID: n1O0S8oD003068 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-3.881, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.52, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@ceid.upatras.gr X-Spam-Status: No Subject: Re: hi X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 24 Feb 2009 00:28:39 -0000 On Mon, 23 Feb 2009 16:09:51 -0500, Jerry wrote: > Specifically, what is it we are uncomfortable putting in the handbook? > More importantly, what good is a handbook if it is not complete? That's one way of looking at it. The obsessive compulsive perfectionist perspective is that a Handbook is *never* complete, because by the time you have finished writing about something in a professional, clean and amusing to read manner, it has been superseded by recent advances :-) > Would the documentation be cross indexed so a user could find more > details on a particular subject? Personally, while perfectly > plausible, it sounds like more work than it is worth. The cross-indexing bits are what made me think about our Wiki while pondering how to write this sort of stuff. I will experiment by writing in plain text first, wikifying bits and pieces later, and see where this leads me.