Skip site navigation (1)Skip section navigation (2)
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>