Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Jan Kundrát <jkt@g.o>
Subject: Re: [RFC] Marking unmaintained documents
Date: Thu, 08 Sep 2005 19:36:08 +0200
Xavier Neys wrote:
>> a) "This article is not part of the official Gentoo documentation, it
>> has been republished on our site only for your convenience and with
>> permisson of the respective copyright owner. It may not reflect current
>> state of things and could be outdated."
> 
> No need to hack the xsl for that, just add it at the beginning of each
> article like we already have the note about owners.

This implies manual changing of several files which is not good, IMHO.

>> b) "This Handbook is no longer maintained and is left here only for your
>> convenience, please don't bother with submitting bugreports. In case you
>> are looking for networkless installation instructions, please consult
>> <link>current handbook</link>."
>> c) "This language is not backed up by an official Translation Team and
>> might be outdated or even incorrect. In doubts please consult
>> [link]original document[/link]."
> 
> 
> Can only be done with a reliable document location made available to the
> xsl which we lack at the moment.
> 
> I wish we could but at the moment, we can't really

Well, I think that fixing <guide path="..."> that does'nt contain
directory name is easier than adding some disclaimer to every file and
could be done by a script (haven't tried, though). And it wouldn't
matter if we didn't catch every outdated/unmaintained/... document, but
at least some of them will be marked.

So, is there any problem to check the value of the path attribute
(provided it includes the directory name) against some regexp and if it
matches, add some warning to the generated page?

Maybe also introduce another parameter to metadoc saying "this
translation is outdated", but I'm not sure if this is worth the effort.

Cheers,
-jkt

-- 
cd /local/pub && more beer > /dev/mouth
Attachment:
signature.asc (OpenPGP digital signature)
Replies:
Re: [RFC] Marking unmaintained documents
-- Xavier Neys
References:
[RFC] Marking unmaintained documents
-- Jan Kundrát
Re: [RFC] Marking unmaintained documents
-- Xavier Neys
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: [RFC] Marking unmaintained documents
Next by thread:
Re: [RFC] Marking unmaintained documents
Previous by date:
Re: [RFC] Marking unmaintained documents
Next by date:
Re: [RFC] Marking unmaintained documents


Updated Jun 17, 2009

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.