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