Gentoo Archives: gentoo-doc

From: Jose Luis Rivero <yoswink@g.o>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Proposal: remove 'last updated' date from rendered page
Date: Wed, 03 Sep 2008 20:14:20
Message-Id: 20080903201403.GB5470@gentoo.org
In Reply to: [gentoo-doc] Proposal: remove 'last updated' date from rendered page by Josh Saddler
1 On Tue, Sep 02, 2008 at 07:14:44PM -0700, Josh Saddler wrote:
2 > Hi guys. I dunno about you, but I'm getting tired of folks bashing our docs
3 > as being "out of date", "stale", "old", or "inaccurate" just because of the
4 > displayed date of the last update.
5 >
6 > I propose that we keep the date inside the document code, for our own
7 > internal purposes, but remove it from the final rendered page.
8
9 As swift has said in previous posts, keep the last change date visible is
10 a quite useful while reading documentation.
11
12 >
13 > As you know, the date displayed has little relevance to when we last
14 > actually touched-up the document, given our internal date bump policy.
15 >
16
17 Or I'm missing something or the date should reflect the date of the last
18 doc version.
19
20 >
21 > So. There's my proposal. Thoughts?
22 >
23
24 What about change 'Updated' to 'Last Change' being 'Last Change' a link
25 which point to an entry in the FAQ explaining what is the last change
26 and why it doesn't imply that the doc is out of date.
27
28 Regards.
29
30 --
31 Jose Luis Rivero <yoswink@g.o>
32 Gentoo/Doc Gentoo/Alpha