Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 44027

Summary: All documentation should have a visible revision number
Product: [OLD] Docs-user Reporter: Andreas Vinsander <andreas>
Component: OtherAssignee: Docs Team <docs-team>
Status: RESOLVED WORKSFORME    
Severity: enhancement    
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---
Attachments: Snapshot of the gentoo handbook upper right corner

Description Andreas Vinsander 2004-03-08 06:02:33 UTC
It should be possible to tell the version of a certain piece of documentation when browsing the gentoo doc web.
Maybe date of modification would be nice to have as well. 
Right now it's too much of a moving target IMHO...

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 Carsten Lohrke (RETIRED) gentoo-dev 2004-03-08 06:31:08 UTC
Maybe you're interested to read Bug 25474. The last modification date is added in the top right corner of every document. A full history with viewable diffs would be cool, though.
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2004-03-08 06:47:53 UTC
Unless you can give me a counter-example all documents have a version number and a date of last modification (on the top right of your screen).

The version numbers and date change when the document has been altered to the extend that the content has changed (i.e. not with typo corrections or grammar fixes).
Comment 3 Andreas Vinsander 2004-03-08 07:01:03 UTC
Created attachment 27027 [details]
Snapshot of the gentoo handbook upper right corner

Uhm, the gentoo handbook does only have a modification date (mistake in my
original bug report, and I should have looked closer to the buglist before
filing...)
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2004-03-08 07:18:22 UTC
Ah yes; the version number isn't shown. The date otoh is. This was due to the fact that displaying version numbers made ppl wonder if a "0.2" document is still in beta, "1.1" is a fixed version of "1.0" and "1.9" will become "2.0" soon(ish) or not.

I.e. too many questions :)

Displaying a date shows when the last update happened which is, imho, sufficient.