Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 17 Dec 2008 23:22:07 -0500
From:      Tom Rhodes <trhodes@FreeBSD.org>
To:        "Murray Stokely" <murray@stokely.org>
Cc:        freebsd-doc@FreeBSD.org
Subject:   Cutting edge -> Upgrading (was: Re: Preface need update.)
Message-ID:  <20081217232207.53615962.trhodes@FreeBSD.org>
In-Reply-To: <2a7894eb0812151835g51d3f64bg5c60d6f8e4fd2497@mail.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>

next in thread | previous in thread | raw e-mail | index | archive | help
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.

This also contains some things I've been working on lately:

o Added a warning about loss of data in GEOM chapter, covers
  a PR about gmirror;

o Add a new section on syslog network monitoring to network-servers;

o Add the Audit chapter to preface.sgml and mark up DTrace with
  &dtrace.

The "additional" parts have already been reviewed by rene and
pgj.  An earlier version of the preface.sgml part was reviewed
by Murray already.

The handbook/ directory has a built version of the handbook
with that diff applied.  If there are no objections I'm
perfectly cool with:

Patching the preface, geom, and network-servers chapters;

Putting in a repo copy request for cutting-edge/chapter.sgml to
upgrading/chapter.sgml;

Commit follow up to note the repocopy;

Commit this version of cutting edge to upgrading/chapter.sgml;

Final commit to remove cutting-edge and updating chapters from
the build and the like.

I'm positive someone will come up with a better way of handling
this but I'm tired and a bit off.

-- 
Tom Rhodes



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