Cutting edge -> Upgrading

[Manolis Kiagias]

Tom Rhodes wrote:
> On Thu, 18 Dec 2008 21:07:34 +0200
> Manolis Kiagias <sonic2000gr at gmail.com> wrote:
>
>   
>> Tom Rhodes wrote:
>>     
>>> Hi Murray, Manolis,
>>>
>>>
>>> On Mon, 15 Dec 2008 18:35:51 -0800
>>> "Murray Stokely" <murray at stokely.org> wrote:
>>>
>>>   
>>>       
>>>> On Mon, Dec 15, 2008 at 11:07 AM, Manolis Kiagias <sonic2000gr at 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
>>>>
>>>>     
>>>>         
>>> 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 <para> 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.