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: Xavier Neys <neysx@g.o>
Subject: Re: [RFC] Marking unmaintained documents
Date: Thu, 29 Sep 2005 17:41:06 +0200
Xavier Neys wrote:

> Adding a disclaimer at the beginning of a doc is a good idea IMO.
> 
> I have implemented a proposal with the following disclaimers:
> "articles" for republished articles
> "oldbook" self-explanatory
> "obsolete" idem
> Disclaimers can also auto-redirect users, very useful for obsolete docs.

I have added "draft" and used attributes (disclaimer & redirect) instead of 
yet another element. It feels better(tm) to me.

> Samples:
> http://gentoo.neysx.org/mystuff/gentoo-x86-install.xml
> http://gentoo.neysx.org/mystuff/l-sed2.xml
> http://gentoo.neysx.org/mystuff/l-sed1.xml
> http://gentoo.neysx.org/mystuff/oldbook.xml
http://gentoo.neysx.org/mystuff/pocketpc-guide.xml


> Now about outdated translations:
Reminder:
> 0) All languages must have a metadoc.xml. Not a problem IMO. <metadoc/> 
> will do for currently unsupported languages.
> 1) We have to use metadoc and *may not* test the corresponding file (ie. 
> s:/pl/:/en/:) as that would force us to keep files we want to remove in 
> /doc/en/ until all translated versions have disappeared.
> 2) Reminder: the date of a handbook is the max_date(master, all parts)
> 3) Some of you need to stop bumping dates needlessly because it would 
> make translations look older then they actually are.
> 4) link attributes must contain the full path, no more <book 
> link="handbook-x86.xml"> (not required on my test site, but would be on 
> www.g.o)

> At the moment, it is limited to /doc as dates are not reliable outside 
> of /doc anyway (not yyyy-mm-dd formatted or not bumped properly).

Sample:
http://gentoo.neysx.org/doc/fr/distcc.xml
> 
> FYI, an inserts would like like
> http://gentoo.neysx.org/doc/en/inserts-en.xml?passthru=1


Disclaimer & redirect
   () Yea  () Nay

Note about more recent English version
   () Yea  () Nay


Cheers,
-- 
/  Xavier Neys
\_ Gentoo Documentation Project
/  French & Internationalisation Lead
\  http://www.gentoo.org/doc/en
/\
-- 
gentoo-doc@g.o mailing list


Replies:
Re: [RFC] Marking unmaintained documents
-- Sven Vermeulen
Re: [RFC] Marking unmaintained documents
-- Flammie Pirinen
Re: [RFC] Marking unmaintained documents
-- Shyam Mani
Re: [RFC] Marking unmaintained documents
-- Łukasz Damentko
Re: [RFC] Marking unmaintained documents
-- Alexey Chumakov
Re: [RFC] Marking unmaintained documents
-- Jose Luis Rivero
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:
Mail Delivery (failure gentoo-doc@g.o)
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.