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: Alexey Chumakov <achumakov@...>
Subject: Re: [RFC] Marking unmaintained documents
Date: Fri, 09 Sep 2005 01:00:27 +0400
Hi GDPers,

Xavier Neys wrote:
> Jan Kundrát wrote:
> 
>> 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
[...]

After some extensive work with mostly outdated Russian docs, I tend to
agree with Jan--we need some means to signal an outdated translation.

My proposition is somewhat simpler --

1. Let the reader decide if the document is outdated :-)
We'll need to link the derived document to source one, and add a
displayed message:
"Source document is available at [link]
[optional version - fetched from source doc if possible
[optional date]"

Attr might look like this:
<guide link="/doc/ru/sample.xml" lang="ru" source-link="/doc/en/sample.xml">

Or, maybe it'll be possible to fetch dependency info from metadoc...

2. It's also useful to introduce some link like "send comments here..."
directly into document, and point it to GDP [internalization] page in
the document's language.
E.g. many Russian readers do not realize easily where to post their bug
reports and suggestions...

3. For unofficial languages, IMHO there is no need to do anything if
there's no index reference to it.
And 3rd party articles are already marked :-)

How do you like this idea?


WKR,
Alexey Chumakov
-- 
gentoo-doc@g.o mailing list


Replies:
Re: [RFC] Marking unmaintained documents
-- Łukasz Damentko
Re: [RFC] Marking unmaintained documents
-- Jan Kundrát
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.