Hello, all.

So considering the previous thread, the Council and QA discussions, I
have prepared a new version of the metadata.xml update. To hopefully
make everyone happy, I come with this three-step process:

1. Add type="" attribute to <maintainer/> tag (see attached patch),

2. Convert <herd/> to <maintainer type="herd"/>,

3. Eventually drop <herd/> from DTD.

If you like the idea, I'll prepare a smart conversion script soon.

As for the exact details, I've pretty much decided to go for featurism
here, IOW making everyone happy. It also proves how absurd typing
maintainers is but if you really feel like having it, sure. The default
is 'developer', <herd/> tags would be converted into 'herd' and there
are other options including 'proxy-maintainer', 'project', 'team' meant
to fit all our wannabies. The diff explains the particular options.

The main benefit of this project over other ideas is that it preserves
backwards compatibility. We're adding a new attribute which should
simply be ignored by old tools. Since we still require <email/> to be
something valid, the output will change a bit but will still be
meaningful (or even more meaningful in some cases).

And since I removed <herd>no-herd</herd> some time ago, we can drop
<herd/> tags without worrying.

Note: this is just about metadata.xml, I'm not touching herds.xml.

What do you think?

Best regards,
Michał Górny
? .git
Index: metadata.dtd
RCS file: /var/cvsroot/gentoo/xml/htdocs/dtd/metadata.dtd,v
retrieving revision 1.13
diff -u -B -r1.13 metadata.dtd
--- metadata.dtd        9 May 2013 06:58:55 -0000       1.13
+++ metadata.dtd        8 Dec 2014 23:38:09 -0000
@@ -13,6 +13,14 @@
   <!-- One tag for each maintainer of a package, multiple allowed-->
   <!ELEMENT maintainer ( email, (description| name)* )>
+    <!-- maintainer organizational type -->
+    <!-- developer: regular Gentoo developer (direct e-mail) -->
+    <!-- herd: herd (defined in herds.xml) -->
+    <!-- project: project (having Wiki/g.o project page) -->
+    <!-- proxy-maintainer: maintainer that is not a Gentoo developer
+      and commits via a proxy -->
+    <!-- team: team of people that is not a herd nor a project -->
+    <!ATTLIST maintainer type (developer|herd|project|proxy-maintainer|team) 
"developer" >
   <!-- Natural name for package, example: LibreOffice (for 
app-office/libreoffice) -->
   <!ELEMENT natural-name (#PCDATA) >

Attachment: pgpsya7u9dz6q.pgp
Description: OpenPGP digital signature

Reply via email to