This page represents the latest version of the asfext:pmc data format.
Please note that the files do not have the same syntax as the project DOAP file(s).
The file is RDF and uses the following namespaces:
Element | Status | Description |
---|---|---|
asfext:pmc | Required | The top level element within a file. This should have an attribute 'rdf:about' that should be set to the internal name of the PMC. |
asfext:name | Required | The name of the PMC, including the 'Apache ', e.g. 'Apache Forrest' NB. There is no need to include 'PMC'. |
foaf:homepage | Optional | If the PMC maintains a webpage providing more details of its activities then this can be included here. NB The link should be added if it provides additional information about the PMC, not if it simply points to a project. As this should point at at a resource link it should be encapsulated within an rdf:resource attribute, i.e. <foaf:homepage rdf:resource="http://foo.apache.org/whoweare.html"> |
asfext:charter | Required | Every PMC is created by a board resolution with a specific charter. That charter should be listed here as it gives the focus and scope of the PMC. |
asfext:chair | Optional | This should contain the name of the current PMC chairperson, encapsulated as a foaf name, e.g.<asfext:chair> <foaf:Person> <foaf:name>Jo Bloggs</foaf:name> </foaf:Person> </asfext:chair>Normally just the name is given, but any additional FOAF elements can be included. |
asfext:member | Optional | A PMC may provide a list of all its members by adding a number of these elements - one per member. The members name (and optionally other information) is provided as a foaf:Person object. Normally just the persons name is given. e.g.<asfext:member> <foaf:Person> <foaf:name>Jo Bloggs</foaf:name> </foaf:Person> </asfext:member> |
The PMC descriptor files are listed in
https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/committees.xml
.
The PMC descriptor file can either be stored in the data/committees/ folder
- i.e. https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/committees/
-
or it can be stored elsewhere, e.g. in the PMC SVN area or on the PMC website area.
In this case, all project DOAP files must refer to the full URL of the PMC descriptor, for example
<asfext:pmc rdf:resource="https://{tlp}.apache.org/pmc/{tlp}.rdf" /> or <asfext:pmc rdf:resource="https://svn.apache.org/repos/asf/{tlp}/trunk/{tlp}.rdf" />In all cases, the file must have the extension '.rdf'. Also, the file must be listed in the file committees.xml - i.e.
https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/committees.xml
-
so that the correct indexes can be generated.
<?xml version="1.0"?> <rdf:RDF xml:lang="en" xmlns="http://usefulinc.com/ns/doap#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:asfext="http://projects.apache.org/ns/asfext#" xmlns:foaf="http://xmlns.com/foaf/0.1/"> <asfext:pmc rdf:about="apr"> <asfext:name>Apache Portable Runtime</asfext:name> <foaf:homepage rdf:resource="https://apr.apache.org/"/> <asfext:charter>The mission of the Apache Portable Runtime (APR) project is to create and maintain software libraries that provide a predictable and consistent interface to underlying platform-specific implementations. The primary goal is to provide an API to which software developers may code and be assured of predictable if not identical behaviour regardless of the platform on which their software is built, relieving them of the need to code special-case conditions to work around or take advantage of platform-specific deficiencies or features. </asfext:charter> <asfext:chair> <foaf:Person> <foaf:name>Garrett Rooney</foaf:name> </foaf:Person> </asfext:chair> <asfext:member> <foaf:Person> <foaf:name>Greg Ames</foaf:name> </foaf:Person> </asfext:member> <asfext:member> <foaf:Person> <foaf:name>Aaron Bannert</foaf:name> </foaf:Person> </asfext:member> ... </asfext:pmc> </rdf:RDF>