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: [RFC] Marking unmaintained documents
Date: Thu, 08 Sep 2005 18:56:26 +0200
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
Attachment:
signature.asc (OpenPGP digital signature)
Replies:
Re: [RFC] Marking unmaintained documents
-- Xavier Neys
Re: [RFC] Marking unmaintained documents
-- Xavier Neys
Re: [RFC] Marking unmaintained documents
-- Xavier Neys
Re: [RFC] Marking unmaintained documents
-- Sven Vermeulen
Re: [RFC] Marking unmaintained documents
-- Flammie Pirinen
Re: [RFC] Marking unmaintained documents
-- Xavier Neys
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Why do we run all commands as root in docs?
Next by thread:
Re: [RFC] Marking unmaintained documents
Previous by date:
Re: Why do we run all commands as root in docs?
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.