From owner-freebsd-doc@FreeBSD.ORG  Fri May 12 13:56:46 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@freebsd.org
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id EA1F416A515
	for <freebsd-doc@freebsd.org>; Fri, 12 May 2006 13:56:46 +0000 (UTC)
	(envelope-from keramida@freebsd.org)
Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 090E143D5E
	for <freebsd-doc@freebsd.org>; Fri, 12 May 2006 13:56:42 +0000 (GMT)
	(envelope-from keramida@freebsd.org)
Received: from gothmog.pc (aris.bedc.ondsl.gr [62.103.39.226])
	(authenticated bits=128)
	by igloo.linux.gr (8.13.6/8.13.6/Debian-1) with ESMTP id k4CDuPbK021632
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Fri, 12 May 2006 16:56:31 +0300
Received: from gothmog.pc (gothmog [127.0.0.1])
	by gothmog.pc (8.13.6/8.13.6) with ESMTP id k4CDwaRW024691;
	Fri, 12 May 2006 16:58:36 +0300 (EEST)
	(envelope-from keramida@freebsd.org)
Received: (from giorgos@localhost)
	by gothmog.pc (8.13.6/8.13.6/Submit) id k4CDwa1f024690;
	Fri, 12 May 2006 16:58:36 +0300 (EEST)
	(envelope-from keramida@freebsd.org)
Date: Fri, 12 May 2006 16:58:36 +0300
From: Giorgos Keramidas <keramida@freebsd.org>
To: Duane Whitty <duane@greenmeadow.ca>
Message-ID: <20060512135836.GA24550@gothmog.pc>
References: <44648EBC.1050309@greenmeadow.ca>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <44648EBC.1050309@greenmeadow.ca>
X-Hellug-MailScanner: Found to be clean
X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (score=-3.953,
	required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.45,
	BAYES_00 -2.60)
X-Hellug-MailScanner-From: keramida@freebsd.org
X-Spam-Status: No
Cc: freebsd-doc@freebsd.org
Subject: Re: [RFC] Understanding the FreeBSD Version Labels
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 12 May 2006 13:56:47 -0000

On 2006-05-12 10:33, Duane Whitty <duane@greenmeadow.ca> wrote:
> Hi,
> I've made my first attempt at SGMLizing the article I was writing.
>
> As well I added some additional content and incorporated several
> suggestions I received.
>
> More review and feedback would be most welcome.

For anyone jumping into the discussion right now, who may have missed
the past posts, the article is online at:

http://www.dwlabs.ca/freebsd/docs/version-labels/article.html

It looks very nice :)

The current `version-guide' article has a TOC that looks like this:

    1. Background
    2. Release Scheduling In The Past
    3. Release Scheduling Goals Going Forward
    4. How Do These Factors Affect My Decision?
    5. Conclusion

Your own TOC is:

    1. Preface
    2. The Labeling of a Version
    3. Conclusion
    4. References and Other Valuable Resources

Perhaps we can join these two in something like this?

    1. Preface (move useful `Background' text here)
    2. The Labeling of a Version
    2. Release Scheduling in the Past
    3. Release Scheduling Goals Going Forward
    4. Conclusion
    5. References and Other Valuable Resources

Then we can commit a new, expanded `version-guide' article that gives us
the best of both :)