From owner-freebsd-doc@FreeBSD.ORG  Mon May 19 20:39:17 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 82D0637B401; Mon, 19 May 2003 20:39:17 -0700 (PDT)
Received: from builder.freebsdmall.com (builder.freebsdmall.com
	[65.86.180.18])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id F2D5643F3F; Mon, 19 May 2003 20:39:16 -0700 (PDT)
	(envelope-from murray@builder.freebsdmall.com)
Received: (from root@localhost)
	by builder.freebsdmall.com (8.12.9/8.11.6) id h4K3dGWA013855;
	Mon, 19 May 2003 20:39:16 -0700 (PDT)
	(envelope-from murray)
Date: Mon, 19 May 2003 20:39:16 -0700
From: Murray Stokely <murray@FreeBSD.org>
To: Robert Watson <rwatson@FreeBSD.org>
Message-ID: <20030519203916.J8403@freebsdmall.com>
References: <Pine.NEB.3.96L.1030519144915.59393K-100000@fledge.watson.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5.1i
In-Reply-To: <Pine.NEB.3.96L.1030519144915.59393K-100000@fledge.watson.org>;
	from rwatson@FreeBSD.org on Mon, May 19, 2003 at 02:54:08PM -0400
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
cc: doc@FreeBSD.org
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 <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 20 May 2003 03:39:17 -0000

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.

     - Murray