From owner-freebsd-doc Tue Apr 4 17:27:52 2000 Delivered-To: freebsd-doc@freebsd.org Received: from server.baldwin.cx (jobaldwi.campus.vt.edu [198.82.67.146]) by hub.freebsd.org (Postfix) with ESMTP id 267DA37B8F5; Tue, 4 Apr 2000 17:27:44 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Received: from john.baldwin.cx (john [10.0.0.2]) by server.baldwin.cx (8.9.3/8.9.3) with ESMTP id UAA01464; Tue, 4 Apr 2000 20:27:37 -0400 (EDT) (envelope-from jhb@FreeBSD.org) Message-Id: <200004050027.UAA01464@server.baldwin.cx> X-Mailer: XFMail 1.4.0 on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <20000404181923.A64168@catkin.nothing-going-on.org> Date: Tue, 04 Apr 2000 20:27:37 -0400 (EDT) From: John Baldwin To: Nik Clayton Subject: Re: Handbook: FreeBSD Internals- Request for Review Cc: freebsd-doc@FreeBSD.org, jim@FreeBSD.org, briggs@ninthwonder.com, dillon@backplane.com, Michael Chin-yuan Wu Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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 s in your doc then become 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 -- 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