Gentoo Archives: gentoo-dev

From: Paul de Vrieze <pauldv@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] Maintainer's guides?
Date: Mon, 28 Nov 2005 11:22:02
Message-Id: 200511281220.13672.pauldv@gentoo.org
In Reply to: Re: [gentoo-dev] Maintainer's guides? by "Diego 'Flameeyes' Pettenò"
1 On Monday 28 November 2005 11:55, Diego 'Flameeyes' Pettenò wrote:
2 > On Monday 28 November 2005 11:39, Paul de Vrieze wrote:
3 > > In any way I like the idea to add a tag to the metadata.xml files. I
4 > > would however want to do it differently. I'd like to propose a
5 > > general <doc> tag with the usual attributes (version/deprange,
6 > > language) and as new attributes a "src" and a "kind" attribute.
7 >
8 > I like this idea, as it would also allow to specify user documentation
9 > that can be found on GDP, allowing users to find out the link to alsa
10 > guide directly from an alsa-* package's metadata.
11 > Maybe instead of a kind attribute we can have a "title" attribute, it
12 > would be anyway simple to recognize maintainers' guides, as they would
13 > be all title="Maintainer's Guide".
14
15 Perhaps we should do both, as "title" attributes are not easy for machines
16 to understand, as they are freeform. The kind attribute would not be and
17 only allow certain values such as: "maintainer", "user",
18 "administration", "troubleshooting", "misc"
19
20 Paul
21
22 --
23 Paul de Vrieze
24 Gentoo Developer
25 Mail: pauldv@g.o
26 Homepage: http://www.devrieze.net

Replies

Subject Author
Re: [gentoo-dev] Maintainer's guides? "Diego 'Flameeyes' Pettenò" <flameeyes@g.o>