Re: [gentoo-doc] Proposal: remove 'last updated' date from rendered page

[Jose Luis Rivero]

On Wed, Sep 03, 2008 at 06:19:53PM +0200, Sven Vermeulen wrote:
> On Wed, Sep 3, 2008 at 4:44 PM, Jan Kundrát <jkt@g.o> wrote:
> > Camille Huot wrote:
> >>
> >> As a workaround, I would suggest to bump the date when an old document
> >> has been checked, tested and certified with current material.
> >
> > If I were yoswink, I'd kill you for such a change.
>
> OMG they killed Cam !!

Not yet. But if someone touch the date for such proposes I will start
with the fingers and finish with the toes =). 

If we want to add metadata about checked/certified then we should use a 
separate tag. The date tag is for what it is.

>
> And, to be on-topic: I'd rather keep the current system. Using a
> "touch" way is imo pointless and more prone to issues (for instance,
> fix a language typo on an outdated document shouldn't bump the date
> nor version as the document is still outdated).

No way of use "touch" for this *shrug*. I've ordered to my slaves that:
http://dev.gentoo.org/~yoswink/tmp/prepare-the-thing.jpg

> Removing the date will silence people who say documents are outdated
> (when they are not) but will probably create voices that would like to
> see a "last modified" date.

Yup, fix a problem creating another is a bad way to go.

> In my opinion, documents should always have a "last modified" date. If
> you want some sort of document lifecycle, you might want to introduce
> a revision period (for instance, every vital doc should be revised
> every 3 months, every other doc every year) and add in two headers:
> "last revision" and "next revision date"...

This belongs to another thread/discussion to me, since it seems like a 
new feature. Maybe too much to fix this problem.

-- 
Jose Luis Rivero <yoswink@g.o>
Gentoo/Doc Gentoo/Alpha