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: Re: [RFC] Marking unmaintained documents
Date: Fri, 09 Sep 2005 15:10:50 +0200
Alexey Chumakov wrote:
> Using the link in the document itself ls like any decentralized way:
> + efficiency -- no need to parse metadoc for each page
> + reliability -- no broken links on metadoc failure
> + flexibility -- works with non-metadoc project docs
> - human factor -- document maintainer is responsible for the link
> - need to update path in several places if source moves

- redundance -- exactly same information is duplicated in several places

> Using metadoc, the pros are:
> + clearness for the lead translator (...or actually not?)
> + simplicity of batch update (isn't often?
> Cons are the opposite.
> 
> Are we centralized or not? :-)

/me is by no means XML guru, but I always thought that metadoc.xml was
made for something like that...

Cheers,
-jkt

-- 
cd /local/pub && more beer > /dev/mouth
Attachment:
signature.asc (OpenPGP digital signature)
References:
[RFC] Marking unmaintained documents
-- Jan Kundrát
Re: [RFC] Marking unmaintained documents
-- Flammie Pirinen
Re: [RFC] Marking unmaintained documents
-- Alexey Chumakov
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: Why do we run all commands as root in docs?


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.