Date: Wed, 4 May 2005 09:30:28 +0300 From: Giorgos Keramidas <keramida@ceid.upatras.gr> To: Benjamin Keating <motionsiren@gmail.com> Cc: Kris Kennaway <kris@obsecurity.org> Subject: Re: The FreeBSD Handbook, in Wiki form. Message-ID: <20050504063027.GA67510@gothmog.gr> In-Reply-To: <781e2bc005050317295898d640@mail.gmail.com> References: <781e2bc0050503170031a960fd@mail.gmail.com> <20050504001546.GA64854@xor.obsecurity.org> <781e2bc005050317295898d640@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2005-05-03 17:29, Benjamin Keating <motionsiren@gmail.com> wrote: >On 5/3/05, Kris Kennaway <kris@obsecurity.org> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050504063027.GA67510>