List Archive: gentoo-doc
1.1 |
On Tue, Sep 02, 2008 at 07:14:44PM -0700, Josh Saddler wrote:
> Hi guys. I dunno about you, but I'm getting tired of folks bashing our docs
> as being "out of date", "stale", "old", or "inaccurate" just because of the
> displayed date of the last update.
>
> I propose that we keep the date inside the document code, for our own
> internal purposes, but remove it from the final rendered page.
As swift has said in previous posts, keep the last change date visible is
a quite useful while reading documentation.
>
> As you know, the date displayed has little relevance to when we last
> actually touched-up the document, given our internal date bump policy.
>
Or I'm missing something or the date should reflect the date of the last
doc version.
>
> So. There's my proposal. Thoughts?
>
What about change 'Updated' to 'Last Change' being 'Last Change' a link
which point to an entry in the FAQ explaining what is the last change
and why it doesn't imply that the doc is out of date.
Regards.
--
Jose Luis Rivero <yoswink@g.o>
Gentoo/Doc Gentoo/Alpha
|
|