Date: Thu, 18 Dec 2008 21:07:34 +0200 From: Manolis Kiagias <sonic2000gr@gmail.com> To: Tom Rhodes <trhodes@FreeBSD.org> Cc: freebsd-doc@FreeBSD.org, Murray Stokely <murray@stokely.org> Subject: Re: Cutting edge -> Upgrading Message-ID: <494A9F76.2020401@gmail.com> In-Reply-To: <20081217232207.53615962.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>
next in thread | previous in thread | raw e-mail | index | archive | help
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 ;) Thanks, manolis
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?494A9F76.2020401>