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>