Bug 18373

Summary:	program versions and document revisions
Product:	[OLD] Docs-user	Reporter:	Lars Juel Nielsen <wheio>
Component:	Other	Assignee:	Docs Team <docs-team>
Status:	RESOLVED WONTFIX
Severity:	normal
Priority:	High
Version:	unspecified
Hardware:	All
OS:	All
Whiteboard:
Package list:		Runtime testing required:	---

Description Lars Juel Nielsen 2003-03-28 10:34:17 UTC

it would be nice if there were a clear marking on all documents that said what
version of the program in question the document was written for and what
revision of the document it is.

this would mmake it a lot easier to keep track of what is and is not up to date
for the documetation team and for the users to be sure they're reading the right
document.

Reproducible: Always
Steps to Reproduce:
1.
2.
3.

Comment 1 Carl Anderson (RETIRED) gentoo-dev

2003-03-28 10:49:57 UTC

Excellent idea.  However, this is the type of bug that can't be fixed at one go.

The Editors are currently going over all of the online documentation; I, along with the rest, will ensure that we test the instructions with the latest available versions and indicate the version we tested with on the document.

I'll change this to "LATER" since I can't find a "WE'LL HAVE TO FIX IT AS WE GO" button. :)

Comment 2 Sven Vermeulen (RETIRED) gentoo-dev

2004-03-07 05:18:47 UTC

reopening

Comment 3 Sven Vermeulen (RETIRED) gentoo-dev

2004-03-07 05:19:47 UTC

Sorry, but this is more of a wontfix situation. It would increase the complexity of maintaining documents and provides not the advantage you can hope for. It's not because tools have newer versions that documents are outdated and knowing that gentoo has a very rapid pace development cycle, it would mean that every doc is outdated a couple of days later.