Incubator Report Format

Having ASF Incubator reports in machine readable format has a number of advantages:

a variety of tooling can be used to update the reports
the machine readable provides visibility about the overall state of a podling and the wider incubator sphere
machine readable formats allow tooling to send automatic reminders to podlings and mentors

Since the format of the file dictates its overall acceptance YAML is the format of these files.

Report Location

The location of the Incubator reports are https://svn.apache.org/repos/asf/incubator/public/trunk/data/reports. Since it is anticipated that more podling and Incubator data will be created in the future, the reports directory is nested inside data.

Report names have the format YYYY-MM.yaml.

YAML Report Format

Sample Report

---
  date: "2014-08"
  timeline: 
    podlings-due: "2014-08-06"
    sheherds-due: "2014-08-10"
    summary-due: "2014-08-10"
    mentor-signoff-due: "2014-08-12"
    board-submission: "2014-08-13"
    board-meeting: "2014-08-13"
  sheperds: 
    optiq: "adc"
    twill: "adc"
    flink: "asavu"
    hdt: "asavu"
    sirona: "johndament"
    slider: "johndament"
  podlings: 
    total: 31
    additions: 
      - "argus"
    graduations: []
    retirements: []
  pmc: 
    total: 201
    additions: 
      - "jani"
    subtractions: []
  releases: 
    tez: 
      - "0.4.1-incubating RC0"
    slider: 
      - "0.40-incubating RC0"
    metamodel: 
      - "incubating 4.2.0"
    devicemap: 
      - "incubating 1.4.1"
    hdt: 
      - "0.0.2.incubating (RC1)"
  ip-clearance: 
    - "Brooklyn-CAMP-Server"
    - "Sling-Query-contribution"
    - "BigCouch-updates-to-Apache-CouchDB"
  legal-trademarks: 
    - "It is unclear whether Blur can get the Trademark assign document provided by trademarks@ signed by Near Infinity.  The company no longer exists."
  on-deck: 
    - "argus"
    - "parquet"
    - "optiq"
    - "sirona"
    - "twill"
  no-release: 
    - "brooklyn"
    - "fleece"
    - "flink"
    - "parquet"
  reports: 
    argus: 
      graduation-issues: 
        - "Get all podling committers and mentors on mailing lists"
        - "Publish initial code drop along with a code grant"
        - "Get approval for name of Argus (PODLINGNAMESEARCH-54)"
        - "Create a project website"
      important-issues: 
        - "part of the discussion about entering incubator, we added a second mentor (Daniel Gruno) from outside of Hortonworks."
      community-development: 
        - "podling accepted into incubator"
        - "all committers have ICLA filed and accounts created"
        - "Jira created"
        - "status page created"
        - "git repostiory created"
        - "mailing lists created"
      project-development: 
        - 
          - "This is the first report"
      date-of-last-release: null
      pmc: 
        total: 5
        additions: 
          - "jani"
        subtractions: []
      committers: 
        total: 6
        additions: 
          - "jani"
        subtractions: []
      mentor-sign-off: 
        gates: "2014-08-01"
        humbedooh: null
        ddas: "2014-08-02"
        jghoman: "2014-08-03"
        omalley: "2014-08-04"