Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 04 Apr 2000 20:27:37 -0400 (EDT)
From:      John Baldwin <jhb@FreeBSD.org>
To:        Nik Clayton <nik@FreeBSD.org>
Cc:        freebsd-doc@FreeBSD.org, jim@FreeBSD.org, briggs@ninthwonder.com, dillon@backplane.com, Michael Chin-yuan Wu <mwu@ece.utexas.edu>
Subject:   Re: Handbook: FreeBSD Internals- Request for Review
Message-ID:  <200004050027.UAA01464@server.baldwin.cx>
In-Reply-To: <20000404181923.A64168@catkin.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help

On 04-Apr-00 Nik Clayton wrote:
> On Sun, Apr 02, 2000 at 11:26:28AM -0500, Michael Chin-yuan Wu wrote:
>> This document is very long.  What should we do about it?
>> A. Split it into several chapter.
>> B. Leave it as is.
> 
>   C. Create the "FreeBSD Hackers Handbook"
> 
> I favour option C. :-), possibly calling it the "FreeBSD Developer's 
> Handbook" instead.  The <sect1>s in your doc then become <chapter>s in
> their own right.
> 
> Trying to stuff everything in to the Handbook is, IMHO, a bad idea.  The
> existing Handbook can be the "Users' Handbook", this new document can be
> for developers.  The two audiences are separate.

I like this idea as well, as well as having a Porter's Handbook, etc.  I
know many people have been anxious to write good kernel developer type
docco (Jeroen!) and this gives them a place to fold their work into the
main distribution and get more eyes, ears, and fingers working on the
task.

-- 

John Baldwin <jhb@FreeBSD.org> -- http://www.FreeBSD.org/~jhb/
PGP Key: http://www.cslab.vt.edu/~jobaldwi/pgpkey.asc
"Power Users Use the Power to Serve!"  -  http://www.FreeBSD.org/


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200004050027.UAA01464>