Gentoo Archives: gentoo-doc

From: Alexey Chumakov <achumakov@×××××.com>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Re: [RFC] Marking unmaintained documents
Date: Mon, 19 Sep 2005 07:52:30
In Reply to: [gentoo-doc] Re: [RFC] Marking unmaintained documents by Xavier Neys
Xavier Neys пишет:
> Notes: > 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) We need to use the dates and not the versions because using the versions > would force us to compare handbooks file by file. > 3) Reminder: the date of a handbook is the max_date(master, all parts) > 4) Some of you need to stop bumping dates needlessly > 5) 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). > > Samples: > > > > FYI, an inserts would like like > > > Please comment. >
As for me, it's good that we only give a hint -- it's up to our user to decide if the doc is really obsolete. Great solution Xavier! WKR, Alexey Chumakov -- gentoo-doc@g.o mailing list