From owner-freebsd-questions@FreeBSD.ORG Wed May 4 06:30:50 2005 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C2A8216A4CE for ; Wed, 4 May 2005 06:30:50 +0000 (GMT) Received: from kane.otenet.gr (kane.otenet.gr [195.170.0.27]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5814443D62 for ; Wed, 4 May 2005 06:30:49 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-a060.otenet.gr [212.205.215.60]) j446T8wn030304; Wed, 4 May 2005 09:29:10 +0300 Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.13.3/8.13.3) with ESMTP id j446USXv081899; Wed, 4 May 2005 09:30:28 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.13.3/8.13.3/Submit) id j446USHd081895; Wed, 4 May 2005 09:30:28 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Wed, 4 May 2005 09:30:28 +0300 From: Giorgos Keramidas To: Benjamin Keating Message-ID: <20050504063027.GA67510@gothmog.gr> References: <781e2bc0050503170031a960fd@mail.gmail.com> <20050504001546.GA64854@xor.obsecurity.org> <781e2bc005050317295898d640@mail.gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <781e2bc005050317295898d640@mail.gmail.com> cc: freebsd-questions@freebsd.org cc: Kris Kennaway Subject: Re: The FreeBSD Handbook, in Wiki form. X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 04 May 2005 06:30:50 -0000 On 2005-05-03 17:29, Benjamin Keating wrote: >On 5/3/05, Kris Kennaway wrote: >>On Tue, May 03, 2005 at 05:00:06PM -0700, Benjamin Keating wrote: >>> Is there anything being done to help keep the handbook just a little >>> more updated? It's a great handbook, if it's content wasn't so out of >>> date. >> >> What is out of date? >> >> Generally, if you want to improve something in the handbook, just >> submit a PR. > > A wiki would eliminate that bottle neck (PR). A wiki comes with its own set of problems though. It's not easy to mirror, its markup language is arbitrarily defined (as opposed to DocBook/SGML), it still requires constant review by a group of dedicated freebsd-doc people, etc. > Some parts are out of date. Others fail to mention FAQ , etc. that > could really help. For instance, the NAT/DHCP articles could easily > include a 'typical home user' HOWTO rather then tricking the user into > reading that one line where it says you have to recompile your kernel > with IPFIREWALL support. Useful comments can always posted to freebsd-doc for discussion. Helpful comments are not only those that contain patches, but also comments of the form: "This section sucks a bit. I can't really understand what the exact steps to rebuild my kernel are." > Things like that bring noise to this mailing list. It's ok. This is part of the purpose of having the list :) - Giorgos