From owner-freebsd-doc@FreeBSD.ORG Tue May 20 04:20:31 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E4BE637B401; Tue, 20 May 2003 04:20:30 -0700 (PDT) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2932A43FE1; Tue, 20 May 2003 04:20:26 -0700 (PDT) (envelope-from hmp@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1072) id 1B20221058; Tue, 20 May 2003 04:20:25 -0700 (PDT) Date: Tue, 20 May 2003 04:20:24 -0700 From: Hiten Pandya To: Murray Stokely Message-ID: <20030520112024.GA63699@perrin.int.nxad.com> References: <20030519203916.J8403@freebsdmall.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030519203916.J8403@freebsdmall.com> X-Operating-System: FreeBSD FreeBSD 4.7-STABLE User-Agent: Mutt/1.5.4i cc: doc@FreeBSD.org cc: Robert Watson Subject: Re: Adding new top-level section to Developer's Handbook: System Architecture? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 May 2003 11:20:32 -0000 On Mon, May 19, 2003 at 08:39:16PM -0700, Murray Stokely wrote: > On Mon, May 19, 2003 at 02:54:08PM -0400, Robert Watson wrote: > > I'm not sure adding a High Level Architecture section is the long term > > solution. The long term solution might be to break it into two books -- > > one on developing/debugging FreeBSD, and the other on developing/debugging > > on FreeBSD. Or perhaps an Architecture/design book separate from a > > practices and procedures book. > > Yes I've been threatening to split this up for years and I think it's > certainly where we need to go in the long run. > > > Regardless, would anyone object to my taking the above described strategy > > for the time being, when I bring in the current draft? > > Not at all. I think bringing it in as a new section is fine for now, > and we'll make sure to coordinate with you when it comes time to split > into two books. Chapter naming in Dev-Handbook is really messed, IMHO. Also, we need to add ``empty still todo'' sections as tags, rather than just naming them inside a chapter. When I get more time, I am thinking of writing a ``Kernel Programming FAQ'' like the one available in NetBSD's doc, but a little more comprehensive. No promises yet. :-) Cheers. -- Hiten (hmp@FreeBSD.ORG)