close
The Wayback Machine - https://web.archive.org/web/20100130025134/http://projects.apache.org:80/guidelines.html
The Apache Software Foundation

General DOAP Guidelines

Formatting

  • rdf:resource should be used when listing URL's instead of the more conventional XML format.
    i.e. <doap:homepage rdf:resource="http://foo" />
    is the correct form to use.
  • the doap:Project element may be embedded in other styles of feed, e.g. within an Atom feed. When included in such a way it should still follow all guidelines, even if this means duplicating information.
  • Dates should be formatted as 'YYYY-MM-DD'. Numbers should be padded with '0' to match the formatting.
    e.g. Jan 1st 2001 should be written as '2001-01-01'

Naming

  • projects should include the 'Apache' prefix when listing their project name.
    i.e. 'Apache HTTPD' instead of 'HTTPD'.
  • programming languages should be given as capitals unless their well known name is mixed case.
    e.g. Java, SVG, Tcl, Perl, etc

    A full list of programming langauges we accept is available here
  • all releases should have a "product" name (added using a doap:name element) included in the doap:Version element.
      i.e.
        "<doap:Version>
          <doap:name>Blah</doap:name>..."
    
  • all URL's should be fully qualified, including the protocol.
    i.e. http://foo.bar.com/file.html
  • PMC's are given as an rdf:resource that points at http://<pmc>.apache.org/. i.e. <asfext:pmc rdf:resource="http://httpd.apache.org/" />
  • The categories that a project should be recorded as being within are recorded as rdf:resource using the following format
     http://projects.apache.org/category/<category>
      e.g. <doap:category rdf:resource="http://projects.apache.org/category/mail" />

    A list of the categories is available here
  • the shortdesc element is use for providing a brief description on index pages and should be included.

Copyright 1999-2008, The Apache Software Foundation

Licensed under the Apache License, Version 2.0.