From owner-freebsd-hackers  Tue Apr 11 17:35:13 2000
Delivered-To: freebsd-hackers@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP
	id 7911137B589; Tue, 11 Apr 2000 17:35:06 -0700 (PDT)
	(envelope-from nik@nothing-going-on.demon.co.uk)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id BAA23240;
	Wed, 12 Apr 2000 01:34:56 +0100 (BST)
	(envelope-from nik)
Date: Wed, 12 Apr 2000 01:34:55 +0100
From: Nik Clayton <nik@freebsd.org>
To: doc@freebsd.org, hackers@freebsd.org
Subject: Structuring the Developer Handbook
Message-ID: <20000412013455.A23096@catkin.nothing-going-on.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0.1i
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-hackers@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.ORG

[ -doc, -hackers, FU set to -doc ]

Recent discussion on -doc has bought forth the suggestion that the 
Handbook could usefully be split in to a number of smaller books.
Rough consensus is that chunks of the existing Handbook should form parts
of a new "FreeBSD Developer Handbook", to cover information useful to 
FreeBSD developers (and developers using FreeBSD).  Specifically, the sort
of people who inhabit -hackers.

http://people.freebsd.org/~nik/developer-handbook/index.html (or /book.html
if you want one big file) shows a very early cut at how the Developer 
Handbook might be structured.  It includes some content culled from the
current Handbook.

What I'd like is feedback on this structure (which is flexible and open
to change) from the developers, along with suggestions for extra material
that should be included.  I'm sufficiently removed from the development
code face to be totally unsure about the best way to organise topics from
a developer's point of view.

Any and all suggestions welcome.

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


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