From owner-freebsd-doc@FreeBSD.ORG Sat Dec 20 00:29:57 2008 Return-Path: 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 43949106564A; Sat, 20 Dec 2008 00:29:57 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id EFE7F8FC08; Sat, 20 Dec 2008 00:29:56 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by pittgoth.com (8.14.3/8.14.3) with ESMTP id mBK0ToOe058188 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 19 Dec 2008 19:29:51 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Fri, 19 Dec 2008 19:29:42 -0500 From: Tom Rhodes To: Manolis Kiagias Message-Id: <20081219192942.2590ef9b.trhodes@FreeBSD.org> In-Reply-To: <494B3BF2.8050600@gmail.com> 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> <2a7894eb0812151835g51d3f64bg5c60d6f8e4fd2497@mail.gmail.com> <20081217232207.53615962.trhodes@FreeBSD.org> <494A9F76.2020401@gmail.com> <20081218220303.36017fa2.trhodes@FreeBSD.org> <494B3BF2.8050600@gmail.com> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: trhodes@FreeBSD.org, freebsd-doc@FreeBSD.org, murray@stokely.org Subject: Re: Cutting edge -> Upgrading X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 20 Dec 2008 00:29:57 -0000 On Fri, 19 Dec 2008 08:15:14 +0200 Manolis Kiagias wrote: > Tom Rhodes wrote: > > On Thu, 18 Dec 2008 21:07:34 +0200 > > Manolis Kiagias wrote: > > > > > >> Tom Rhodes wrote: > >> > >>> Hi Murray, Manolis, > >>> > >>> > >>> On Mon, 15 Dec 2008 18:35:51 -0800 > >>> "Murray Stokely" wrote: > >>> > >>> > >>> > >>>> On Mon, Dec 15, 2008 at 11:07 AM, Manolis Kiagias 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 > >>>> > >>>> > >>>> > >>> Apologies for this tardy reply, but I've recently come down > >>> with some kind of a bug. Anyway, this is what I have right now: > >>> > >>> http://people.freebsd.org/~trhodes/doc/latest-handbook.diff > >>> > >>> http://people.freebsd.org/~trhodes/doc/handbook/ > >>> > >>> The diff contains my Updating chapter placed above the current > >>> cutting-edge content along with some alterations to make the > >>> documentation flow a bit. Surely another update or two will > >>> be needed to perfect this version, but I think it looks pretty > >>> decent as it is now. > >>> > >>> > >>> > >> Thanks Tom, this is more or less what I had in mind for the > >> updating-upgrading chapter :) > >> Having read the synopsis, I feel we need to change it a bit so it > >> matches more closely the updated content. > >> Something like this: > >> > >> http://people.freebsd.org/~manolis/updating-upgrading.html#UPDATING-UPGRADING-SYNOPSIS > >> > >> and the patch: > >> > >> http://people.freebsd.org/~manolis/cutting-edge.txt > >> > >> Basically this rephrases the original a bit, and also reorders > >> the itemized list to more or less match the order the info is presented > >> in the chapter. Feel free to change it as you see fit ;) > >> > > > > This version of the patch has been applied to my try, and > > integrated with the latest changes done by Murray today. > > > > The latest patch and build handbook version is up here: > > > > http://people.FreeBSD.org/~trhodes/doc > > > > Please let me know how you feel about it. Other than the > > directory name issue (cutting edge v. updating-upgrading), I > > think it's pretty nice. We should consider moving forward > > should no one object. Thanks, > > > > > > Yes, it looks fine to me. > As a final touch, maybe it would be nice to change the title of section > 24.4 from: > > 24.4 FreeBSD-CURRENT vs. FreeBSD-STABLE > > to > > 24.4 Tracking a Development Branch > > I think this flows better now that the chapter does not exclusively deal > with CURRENT and STABLE. Actually sounds rather nice, updated in my local patch. Let me run around with Giorgos a bit here and I'll have a new handbook and diff posted. Thanks, -- Tom Rhodes