The FreeBSD Handbook, in Wiki form.

Giorgos Keramidas keramida at ceid.upatras.gr
Tue May 3 23:30:50 PDT 2005


On 2005-05-03 17:29, Benjamin Keating <motionsiren at gmail.com> wrote:
>On 5/3/05, Kris Kennaway <kris at 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



More information about the freebsd-questions mailing list