Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Joshua Saddler <nightmorph@g.o>
Subject: New version format
Date: Mon, 6 Dec 2010 03:44:44 -0800
I made a few changes to our Tips'n'Tricks guide:

http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml

What:

New format for the <version> string. No more decimal numbers from
now on. Just whole numbers. Only <version>3</version>,
<version>11</version>, <version>101</version>, etc.

Why:

This is something we started doing back in 2007 or so. I've been
working on getting this standardized. Whole numbers really are much
simpler. The "point-whatever" is entirely meaningless, since we don't
have archived, versioned documentation. It has no relation to the
actual content of the document.

When:

For all new documents from this point forward. For old documents not
yet using the new format, *the next time* you make a change to it,
bump the version upward to the nearest whole number:

9.7 -> 10
4.13 -> 5
0.65 -> 1
1.24 -> 2

. . . and so on. Include the new <version> with the rest of your
content commit.

* * * Exception * * *

DON'T apply the new version format to metadoc.xml. I want to keep
metadoc's decimal number for now. It's more useful as an indicator
of how frequently the file is changed. (I realize that its version
string doesn't match CVS history. CVS says 234 revisions,
internal <version> says 1.156 - no idea why the huge disparity.)


Thanks!
Attachment:
signature.asc (PGP signature)
Replies:
Re: New version format
-- Tobias Heinlein
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: [gentoo-doc-cvs] gentoo commit in xml/htdocs/proj/en/gdp/doc: doc-tipsntricks.xml
Next by thread:
Re: New version format
Previous by date:
Re: [gentoo-doc-cvs] gentoo commit in xml/htdocs/proj/en/gdp/doc: doc-tipsntricks.xml
Next by date:
Re: [PATCH] Corrections to doc/en/genkernel.xml


Updated Mar 27, 2012

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.