From owner-freebsd-doc  Tue Apr 11 18:50:30 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from smtp02.teb1.iconnet.net (smtp02.teb1.iconnet.net [209.3.218.43])
	by hub.freebsd.org (Postfix) with ESMTP
	id 3A8C037BB46; Tue, 11 Apr 2000 18:50:28 -0700 (PDT)
	(envelope-from babkin@bellatlantic.net)
Received: from bellatlantic.net (client-151-198-135-164.bellatlantic.net [151.198.135.164])
	by smtp02.teb1.iconnet.net (8.9.1/8.9.1) with ESMTP id VAA15996;
	Tue, 11 Apr 2000 21:50:25 -0400 (EDT)
Message-ID: <38F3D862.6D204287@bellatlantic.net>
Date: Tue, 11 Apr 2000 21:58:58 -0400
From: Sergey Babkin <babkin@bellatlantic.net>
X-Mailer: Mozilla 4.7 [en] (X11; U; FreeBSD 4.0-19990626-CURRENT i386)
X-Accept-Language: ru, en
MIME-Version: 1.0
To: Nik Clayton <nik@freebsd.org>
Cc: doc@freebsd.org
Subject: Re: Structuring the Developer Handbook
References: <20000412013455.A23096@catkin.nothing-going-on.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Nik Clayton wrote:
> 
> [ -doc, -hackers, FU set to -doc ]

> 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

I'd suggest adding chapters on the general interface of
the modular kernel subsystems before the chapters on particular 
implementations. For example, instead:

-File systems
--FFS
--MFS
...

do

-File systems
--File system interface (or Writing a filesystem)
--FFS
--MFS
...

-SB


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