Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 19 Dec 2008 08:15:14 +0200
From:      Manolis Kiagias <sonic2000gr@gmail.com>
To:        Tom Rhodes <trhodes@FreeBSD.org>
Cc:        freebsd-doc@FreeBSD.org, murray@stokely.org
Subject:   Re: Cutting edge -> Upgrading
Message-ID:  <494B3BF2.8050600@gmail.com>
In-Reply-To: <20081218220303.36017fa2.trhodes@FreeBSD.org>
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>

next in thread | previous in thread | raw e-mail | index | archive | help
Tom Rhodes wrote:
> On Thu, 18 Dec 2008 21:07:34 +0200
> Manolis Kiagias <sonic2000gr@gmail.com> wrote:
>
>   
>> Tom Rhodes wrote:
>>     
>>> Hi Murray, Manolis,
>>>
>>>
>>> On Mon, 15 Dec 2008 18:35:51 -0800
>>> "Murray Stokely" <murray@stokely.org> wrote:
>>>
>>>   
>>>       
>>>> 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
>>>>
>>>>     
>>>>         
>>> 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.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?494B3BF2.8050600>