| 1 |
I made a few changes to our Tips'n'Tricks guide: |
| 2 |
|
| 3 |
http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml |
| 4 |
|
| 5 |
What: |
| 6 |
|
| 7 |
New format for the <version> string. No more decimal numbers from |
| 8 |
now on. Just whole numbers. Only <version>3</version>, |
| 9 |
<version>11</version>, <version>101</version>, etc. |
| 10 |
|
| 11 |
Why: |
| 12 |
|
| 13 |
This is something we started doing back in 2007 or so. I've been |
| 14 |
working on getting this standardized. Whole numbers really are much |
| 15 |
simpler. The "point-whatever" is entirely meaningless, since we don't |
| 16 |
have archived, versioned documentation. It has no relation to the |
| 17 |
actual content of the document. |
| 18 |
|
| 19 |
When: |
| 20 |
|
| 21 |
For all new documents from this point forward. For old documents not |
| 22 |
yet using the new format, *the next time* you make a change to it, |
| 23 |
bump the version upward to the nearest whole number: |
| 24 |
|
| 25 |
9.7 -> 10 |
| 26 |
4.13 -> 5 |
| 27 |
0.65 -> 1 |
| 28 |
1.24 -> 2 |
| 29 |
|
| 30 |
. . . and so on. Include the new <version> with the rest of your |
| 31 |
content commit. |
| 32 |
|
| 33 |
* * * Exception * * * |
| 34 |
|
| 35 |
DON'T apply the new version format to metadoc.xml. I want to keep |
| 36 |
metadoc's decimal number for now. It's more useful as an indicator |
| 37 |
of how frequently the file is changed. (I realize that its version |
| 38 |
string doesn't match CVS history. CVS says 234 revisions, |
| 39 |
internal <version> says 1.156 - no idea why the huge disparity.) |
| 40 |
|
| 41 |
|
| 42 |
Thanks! |
Archives