Gentoo Archives: gentoo-doc

From: "Jan Kundrát" <jkt@g.o>
To: gentoo-doc@l.g.o
Subject: [gentoo-doc] [RFC] Marking unmaintained documents
Date: Thu, 08 Sep 2005 16:57:29
Message-Id: 43206D3A.5030406@gentoo.org
Hi GDP-related entities,
as promised on IRC, here are my ideas about $SUBJECT.

Currently we have quite a lot of "unsupported"/"invalid"/"unmaintained"
documents for one of these reasons:

a) Third party article
b) Older Handbook
c) Translation in language which is not officially supported
d) Outdated translation

First three cases are easily detectable, fourth can't be checked easily
("what is outdated translation?"), AFAIK & IMHO.

So, the proposed change is to modify the XSL stylesheet to include some
bold red warning (with proper i18n, if possible) stating that the
document is no longer/not yet/... supproted, for example:

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."

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]."

Some random resources:
http://bugs.gentoo.org/show_bug.cgi?id=105248 - l-posix3.xml:
control_destroy() calls pthread_cond_destroy() twice

All opinions are welcome.

-jkt

-- 
cd /local/pub && more beer > /dev/mouth

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies