Clutch is a tool which gathers details about the projects currently in incubation and re-generates the table below. It aims to encourage and nurture, to provide an overview of the state of establishment of various resources, and to provide quick access to those resources. See more notes below regarding purpose and interpretation.

• The orange items indicate where more care and attention is needed. Anything vermilion is an issue that should be addressed ASAP. The bluish-green items indicate success and the yellow items are okay.
• A: startDate
• B: elapsedDays - <3 <12 <18 <24 >24 months
• C: reportingMonthly in w.a.o/incubator/ReportingSchedule (current report: November2009)
• D: reportingGroup - in which set of months do they report:
  group-1=Jan,Apr,Jul,Oct group-2=Feb,May,Aug,Nov group-3=Mar,Jun,Sep,Dec
• E: hasReportingGroup - did podling remember to choose a group
• F: hasStatusEntry in i.a.o/projects (the main "Currently in incubation" table)
• G: statusUpdateDate - the status page was last updated
• H: statusAge - days since the SVN status page was last updated - <2 <4 <9 >9 months
• I: statusUpdateCounts - number of commits to status file in the previous 2,4,9 months (cumulative)
• J: numberCommitters - accounts have been established, total number to date
• K: numberCommittersNew - new committers added since establishment (gathered from each project's Status page "News" section)
• L: hasSvn - Subversion repository is created
• M: hasTracker - has an Issue Tracker
• N: hasMailListDev - has dev mail list and archives
• O: hasMailListCommits - has commits mail list and archives
• P: hasWebSite
• Q: hasDistributionArea - has w.a.o/dist/incubator/... area (not necessarily yet a release)
• R: hasKeys - has a PGP KEYS file in their distribution area
• S: hasRelease - has a release in their distribution area
• other issues listed below for: abdera sanselan buildr sling couchdb pig tika

Clutch last gathered: Thu Nov 19 04:16:51 2009 UTC.
Number of podlings in incubation: 38

Occasionally there are other issues, e.g. Not listed in ReportingSchedule, yet listed in IncubationTable.

• abdera: Has graduated, but still has remains on Incubator distribution mirrors. See help.
• buildr: Has graduated, but still has remains on Incubator distribution mirrors. See help.
• couchdb: Has graduated, but still has remains on Incubator distribution mirrors. See help.
• pig: Has graduated, but still has remains on Incubator distribution mirrors. See help.
• sanselan: Has graduated, but still has remains on Incubator distribution mirrors. See help.
• sling: Has graduated, but still has remains on Incubator distribution mirrors. See help.
• tika: Has graduated, but still has remains on Incubator distribution mirrors. See help.

Any Incubator committer can run 'clutch'. In the top-level of the "incubator/public/trunk" SVN, do: 'python clutch.py' which will generate a source xml file at "site-author/clutch.xml". Do 'svn diff' to see what changed. Then build and deploy the site as normal.

It reads the Wiki page at ReportingSchedule then builds a list of projects, adds some attributes, does some validation. Then it reads the source file for the "projects currently in incubation" table, ensures that each new project has an entry, adds some more attributes. Clutch then gathers some data from each project's Status page, makes other guesses, and validates that certain facilities are established and steps are achieved.

The clutch is the set of eggs which have been laid. The mother hen (our Incubator PMC) needs to continually gather them, to ensure that none have rolled from the nest or moved to the outside, being forgotten or becoming cold. Clutch also means to grasp eagerly.

So please interpret this table from the point-of-view of encouragement and nurture.

Essentially Clutch is helping us all to follow the process from the "Acceptance" phase onwards (explained in Process Description and Incubation Policy and Mentor Guide and Other Guides and summarised at Podling Bootstrap). Any committer on a podling can help with these steps. Don't leave it to your mentors, although there are some steps that only they can do.

The first steps are the "Acceptance" phase. See doc and doc and doc.

The orange and vermilion items indicate where more care and attention is needed. The following notes for each column, expand on the column definitions above and attempt to link directly to the relevant process documentation:

• Project - If your project is in incubation, but is missing from the Clutch table, then you have forgotten to add it to the Wiki ReportingSchedule. (doc and doc)
• Sponsor - This information is gathered from the list of Projects in incubation summary table. The "not known" is because it is missing from that table. See notes for "hasStatusEntry" below.
• A: startDate - This information is gathered from the list of Projects in incubation summary table. The "not known" is because it is missing from that table.
• B: elapsedDays - Calculated from startDate.
• C: reportingMonthly in ReportingSchedule.
• D: reportingGroup - in which set of months do they report.
• E: hasReportingGroup - did podling remember to choose a group. See notes for "Project" above.
• F: hasStatusEntry in Projects in incubation table and an associated project Status page. (doc and doc and doc and doc)
• G: statusUpdateDate - the status page was last updated. Clutch does an 'svn log' query for the project's Status page.
• H: statusAge - days since the SVN status page was last updated
• I: statusUpdateCounts - number of commits to status file in the previous 2,4,9 months (cumulative). Clutch does an 'svn log' query for the project's Status page, and counts the edits for those time ranges.
• J: numberCommitters - accounts have been established, total number to date. Clutch parses the relevant section of the ASF Committers by Project Modules page and counts the total, including mentors.
• K: numberCommittersNew - new committers added since establishment (gathered from each project's Status page "News" section). Clutch parses the News section and detects the string "new committer", counting each matched line. See notes for "hasStatusEntry" above. (doc and doc and doc)
• L: hasSvn - Subversion repository is created. (doc and doc)
• M: hasTracker - has an Issue Tracker
• N: hasMailListDev -
• O: hasMailListCommits -
• P: hasWebSite -
• Q: hasDistributionArea - has w.a.o/dist/incubator/... area (not necessarily yet a release)
• R: hasKeys - has a PGP KEYS file in their distribution area
• S: hasRelease - has a release in their distribution area. The test is whether they have a signature file (*.asc or *.sig ) associated with a source release artifact (*.tar.gz or *.tgz or *.bz2 or *zip) and the filename includes the word "incubating". (doc and doc)
• otherIssues - When projects graduate or become dormant, then they need to clean up.
• Graduate - Remove from the ReportingSchedule. In the Projects in incubation table, move it to the "Graduated" section. Remove entry from right-side panel. Do various other tasks listed in the docs. (doc and doc)
• Dormant or Retired - Remove from the ReportingSchedule. In the Projects in incubation table, move it to the "Dormant" or "Retired" section. Remove entry from right-side panel. (doc)

This list is gathered from the Projects in incubation summary table.

• Alan Cabrera: Shiro, VCL
• Andrew Savory: Wookie
• Andrus Adamchik: Click
• Ant Elder: Cassandra, Kato, Libcloud
• Ate Douma: Wookie
• Bertrand Delacretaz: Ace, Aries, ESME
• Bill Stoddard: Bluesky, Imperius
• Brett Porter: Hama
• Brian Fitzpatrick: Shindig
• Brian McCallister: Cassandra, Shindig
• Carlos Sanchez: Libcloud
• Carsten Ziegeler: Ace
• Craig Russell: Imperius, JSPWiki, Olio, Shiro, Tashi
• Dan Kulp: Stonehenge
• Danese Cooper: Stonehenge
• Daniel Kulp: ESME
• Daniel Rall: Subversion
• Davanum Srinivas: Aries, Wink
• Dave Johnson: JSPWiki, SocialSite
• Doug Cutting: Etch, Thrift, TrafficServer
• Emmanuel Lecharny: Shiro
• Erik Hatcher: Lucene.Net
• Felix Meschberger: Chemistry
• Filip Hanik: Imperius
• Gavin McDonald: Libcloud, Log4php, Wookie
• Geir Magnusson Jr: River
• Geir Magnusson Jr.: Kato
• Gianugo Rabellino: Chemistry, ESME, River
• Glen Daniels: HISE
• Grant Ingersoll: Droids
• Greg Stein: Shindig, Subversion
• Guillaume Nodet: Aries
• Henning Schmiedehausen: Click, Empire-db, JSPWiki, Olio, SocialSite, Wookie
• Ian Holsman: Hama
• J. Aaron Farr: Bluesky, ESME
• Jean-Frederic Clere: Libcloud, TrafficServer
• Jeff Eastman: Hama
• Jim Jagielski: Log4php, RAT, Stonehenge, TrafficServer
• Jochen Wiedmann: VXQuery
• Jukka Zitting: Chemistry
• Justin Erenkrantz: Subversion
• Ken Coar: Stonehenge, UIMA
• Kevan Miller: Aries, Imperius, OpenWebBeans, VCL, Wink
• Luciano Resende: PhotArk, Wookie
• Martijn Dashorst: Empire-db, Pivot
• Martin Cooper: PhotArk
• Matt Hogstrom: Olio, RAT, VCL
• Matthias Wessendorf: OpenWebBeans
• Matthieu Riou: Cassandra, HISE, Stonehenge, Tashi
• Mladen Turk: TrafficServer
• Nick Kew: TrafficServer
• Niclas Hedhman: Ace, Etch, Log4php, Pivot
• Paul Fremantle: Droids, HISE, Shiro, Stonehenge, Tashi, VXQuery
• Paul Querna: Libcloud
• Phil Steitz: River
• Portals PMC members: WSRP4J
• Radu Preotiuc-Pietro: VXQuery
• Rick Hillegas: Olio
• Robert Burrell Donkin: Kato
• Ross Gardler: Droids, RAT, Wookie
• Sam Ruby: JSPWiki, UIMA
• Sander Striker: Subversion
• Sanjiva Weerawarana: VXQuery
• Santiago Gala: Shindig
• Steve Loughran: Wink
• Sylvain Wallez: ESME, Shindig, Wookie
• Ted Husted: Click
• Thomas Dudziak: Shindig
• Thomas Fischer: Empire-db
• Upayavira: Shindig
• Will Glass-Husain: Click
• Yoav Shapira: RAT
• Yonik Seeley: Etch

Data files are also generated so that other tools can easily re-use the metadata for the set of projects currently in incubation:

• clutch.txt - list of projects, one per line. Comma-separated values (CSV).
• clutch.pkl - a Python "pickle" file with various attributes (it is in the top-level of SVN incubator/public/trunk).
• Structured list of various details. Not yet happening - need to decide which format (e.g. RDFa, etc.) and which attributes to be stored.