The Apache Software Foundation

DOAP Extensions: PMC Data

The PMC data format is still evolving!

This page represents the latest version of the asfext:pmc file format.

The file is RDF and uses the following namepsaces

  • 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/"
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 Required 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 elemts 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 file can either be stored in the data_files/ folder - i.e. https://svn.apache.org/repos/asf/infrastructure/site-tools/trunk/projects/data_files/ - 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="http://{tlp}.apache.org/pmc/{tlp}.rdf" />
or
<asfext:pmc rdf:resource="http://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 pmc_files.xml - i.e. https://svn.apache.org/repos/asf/infrastructure/site-tools/trunk/projects/pmc_files.xml - so that the correct indexes can be generated.

Example

<?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>
    <asfext:chair>
      <foaf:Person>
        <foaf:name>Garrett Rooney</foaf:name>
      </foaf:Person>
    </asfext:chair>
    <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:PMC>
</rdf:RDF>

Copyright 1999-2014, The Apache Software Foundation

Licensed under the Apache License, Version 2.0.

Generated Fri, 01 Aug 2014 00:30:33 GMT