From owner-freebsd-doc@FreeBSD.ORG  Tue Dec 16 02:35:54 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 009E71065673;
	Tue, 16 Dec 2008 02:35:54 +0000 (UTC)
	(envelope-from murray@stokely.org)
Received: from mail-ew0-f21.google.com (mail-ew0-f21.google.com
	[209.85.219.21])
	by mx1.freebsd.org (Postfix) with ESMTP id 6612A8FC08;
	Tue, 16 Dec 2008 02:35:53 +0000 (UTC)
	(envelope-from murray@stokely.org)
Received: by ewy14 with SMTP id 14so3987052ewy.19
	for <multiple recipients>; Mon, 15 Dec 2008 18:35:52 -0800 (PST)
Received: by 10.210.124.8 with SMTP id w8mr8618480ebc.92.1229394952022;
	Mon, 15 Dec 2008 18:35:52 -0800 (PST)
Received: by 10.210.71.14 with HTTP; Mon, 15 Dec 2008 18:35:51 -0800 (PST)
Message-ID: <2a7894eb0812151835g51d3f64bg5c60d6f8e4fd2497@mail.gmail.com>
Date: Mon, 15 Dec 2008 18:35:51 -0800
From: "Murray Stokely" <murray@stokely.org>
To: "Manolis Kiagias" <sonic2000gr@gmail.com>
In-Reply-To: <4946AAD6.6050300@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <1226494693.1809.10.camel@localhost>
	<20081112200755.66c52a48.trhodes@FreeBSD.org>
	<491C39E7.7040609@gmail.com>
	<20081113185333.25a73ebf.trhodes@FreeBSD.org>
	<2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.gmail.com>
	<20081214185058.48a7c2c2.trhodes@FreeBSD.org>
	<2a7894eb0812141832u20af4821h121a520fab746c7c@mail.gmail.com>
	<20081215062858.6c76fb33.trhodes@FreeBSD.org>
	<20081215134919.51a88d90.trhodes@FreeBSD.org>
	<4946AAD6.6050300@gmail.com>
Cc: Tom Rhodes <trhodes@freebsd.org>, freebsd-doc@freebsd.org
Subject: Re: Preface need update.
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
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, 16 Dec 2008 02:35:54 -0000

On Mon, Dec 15, 2008 at 11:07 AM, Manolis Kiagias <sonic2000gr@gmail.com> wrote:
> If these chapters are merged, I think we will have to rethink the "The
> Cutting Edge" title. The title is by itself intimidating for the
> beginning-intermediate user who is already convinced it is best for him
> to use "RELEASE" until he is comfortable with the system. And using
> freebsd-update is essential (and a rather easy task) at any user level.
>
> How about changing the chapter to something like "Updating and Upgrading
> FreeBSD"?
> The first sections could deal with security updates and minor / major
> version upgrades using freebsd-update.
> Later sections could deal with -STABLE and -CURRENT
> It would probably need more than a few rewrites and reorganization though

Yea I think this sounds good.  Tom, can you include a link to the HTML
with your next diff -- I find it easier to review big reorganizations
in the built html form rather than the diffs.

If there is really just too much content for one chapter then maybe
the updating and upgrading chapter could still be split into two
adjacent chapters -- one for the basics of updrading between releases
with mergemaster and such, and a second with more complicated source
upgrades to -CURRENT.

          - Murray