From owner-freebsd-doc@FreeBSD.ORG Thu Dec 18 19:07:39 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 59D5E1065674 for ; Thu, 18 Dec 2008 19:07:39 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from mail-ew0-f21.google.com (mail-ew0-f21.google.com [209.85.219.21]) by mx1.freebsd.org (Postfix) with ESMTP id B94B28FC1D for ; Thu, 18 Dec 2008 19:07:38 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ewy14 with SMTP id 14so774171ewy.19 for ; Thu, 18 Dec 2008 11:07:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=o6+SrVYAF8vfljVpKCm9f+TAQmMD6xYKuQ27fLYFz2A=; b=YxxOZo+cmiPCn1I9ePuPQ8iaozBVf03i3txxiCAiIWh/HMAcBHSnicx/bYmWeduflA /jyep+0doiVELtpdncEE75W0BUa0djnC2j+d1XVgqSl+vFXg19PeuVSeUy3SWUWK1x7+ 4uzS4B3JnbdRh6DFJuBnk11v53JMuJfujexU8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=Ed8oTDcPPTXm7qIk2I+bEgtKYY73ZgclmTHoyHKvDyuqI70uZVBWv9kqkHqYMJ30aH R9c1y1orrOhsjqep/OOjcPC3T2J0yZ2sW9/N5Fvd2sRZG//WMp+54U4t2I1wiknUGY9F cjVJki3ZIutfq6/xzA/DPj8CGVw6yAGVBmX+k= Received: by 10.210.43.11 with SMTP id q11mr2710623ebq.48.1229627257533; Thu, 18 Dec 2008 11:07:37 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-279638.home.otenet.gr [85.73.139.244]) by mx.google.com with ESMTPS id i7sm6833977nfh.53.2008.12.18.11.07.35 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 18 Dec 2008 11:07:36 -0800 (PST) Message-ID: <494A9F76.2020401@gmail.com> Date: Thu, 18 Dec 2008 21:07:34 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Tom Rhodes 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> In-Reply-To: <20081217232207.53615962.trhodes@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, Murray Stokely Subject: Re: Cutting edge -> Upgrading X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 18 Dec 2008 19:07:39 -0000 Tom Rhodes wrote: > Hi Murray, Manolis, > > > On Mon, 15 Dec 2008 18:35:51 -0800 > "Murray Stokely" wrote: > > >> On Mon, Dec 15, 2008 at 11:07 AM, Manolis Kiagias 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 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