The Apache Software Foundation
The Apache Software Foundation Incubator
    

Incubator Clutch Status

Clutch is a tool which gathers details about the projects (podlings) currently in incubation and generates the table below. Clutch also generates an analysis page for each podling, along with several data files. Its aim is to encourage and nurture podlings; and to provide an overview of the state of establishment of various resources, and quick access to thems. See definitions and notes below regarding purpose, interpretation, and how-to.

Clutch

Clutch last gathered: Wed Oct 27 01:39:04 2021 UTC.

Number of podlings in incubation: 37

Current Board Report: October2021

Quick Notes

  • The orange items indicate where the podling needs to take more care and attention.

  • Anything vermilion is an issue that the podling should address ASAP. Admittedly nothing can be done about elapsed time.

  • The bluish-green items indicate success.

  • The yellow items are okay.

  • Click the column header link for definitions.

  • Click cells to go to available related resources.

  • Click the podling name in the first column to go to the podling’s clutch analysis page, which has deeper and more detailed information.

Podling Sponsor A B C D E F G H I J K L M N O P Q R

AGE

Incubator

2020-04-29

546

False

3

True

2021-10-20

7

5,7,13

14

3

True

True

True

True

True

True

True

True

Annotator

Incubator

2016-08-30

1884

False

1

True

2020-10-09

383

0,0,0

7

0

True

False

True

True

True

True

True

True

BlueMarlin

Incubator

2020-06-09

505

False

1

True

2020-10-08

384

0,0,0

9

0

True

False

True

False

False

False

False

False

brpc

Incubator

2018-11-13

1079

False

3

True

2020-10-08

384

0,0,0

14

0

True

False

True

False

True

True

True

True

Crail

Incubator

2017-11-01

1456

False

3

True

2020-10-09

383

0,0,0

10

0

True

True

True

True

True

True

True

True

DataLab

Incubator

2018-08-20

1164

False

1

True

2021-09-02

55

1,1,5

29

11

True

True

True

True

True

True

True

True

Doris

Incubator

2018-07-18

1197

False

2

True

2020-10-08

384

0,0,0

28

0

True

True

True

True

True

True

True

True

EventMesh

Incubator

2021-02-18

251

False

1

True

2021-02-24

245

0,0,3

21

0

True

True

True

True

True

True

True

True

Flagon

Incubator

2016-07-13

1932

False

1

True

2021-06-03

146

0,0,1

13

0

True

True

True

True

True

True

True

True

Heron

Incubator

2017-06-23

1587

False

2

True

2020-10-09

383

0,0,0

31

0

True

False

True

True

True

True

True

True

Hivemall

Incubator

2016-09-13

1870

True

3

True

2020-10-09

383

0,0,0

9

0

True

True

True

True

True

True

True

True

Hop

Incubator

2020-09-24

398

False

3

True

2021-10-11

16

1,1,1

19

0

True

True

True

True

True

True

True

True

InLong

Incubator

2019-11-03

724

False

1

True

2021-09-13

44

1,1,1

25

0

True

False

True

True

True

True

True

True

Kyuubi

Incubator

2021-06-21

128

True

3

True

2021-06-25

124

0,0,2

9

0

True

False

True

True

True

True

True

True

Liminal

Incubator

2020-05-23

522

False

1

True

2020-10-08

384

0,0,0

9

0

True

False

True

True

True

True

True

True

Linkis

Incubator

2021-08-02

86

True

2

True

2021-08-10

78

0,3,-

19

0

True

False

True

True

True

False

False

False

Livy

Incubator

2017-06-05

1605

False

1

True

2017-06-23

1587

0,0,0

9

0

True

False

True

True

True

True

True

True

Marvin-AI

Incubator

2018-08-21

1163

False

3

True

2020-10-08

384

0,0,0

13

0

True

True

True

True

True

False

False

False

Milagro

Incubator

2015-12-21

2137

False

1

True

2019-06-02

878

0,0,0

13

0

True

False

True

True

True

True

True

True

MXNet

Incubator

2017-01-23

1738

False

1

True

2021-02-11

258

0,0,1

85

0

True

True

True

True

True

True

True

True

Nemo

Incubator

2018-02-04

1361

False

3

True

2018-03-01

1336

0,0,0

16

0

True

True

True

True

True

True

True

True

NLPCraft

Incubator

2020-02-13

622

False

2

True

2020-10-08

384

0,0,0

11

1

True

False

True

True

True

True

True

True

NuttX

Incubator

2019-12-09

688

False

1

True

2020-10-08

384

0,0,0

25

0

True

True

True

True

True

True

True

True

PageSpeed

Incubator

2017-09-30

1488

False

2

True

2020-10-08

384

0,0,0

10

0

True

False

True

True

True

True

True

True

Pegasus

Incubator

2020-06-28

486

False

1

True

2020-10-08

384

0,0,0

15

0

True

True

True

True

True

True

True

True

Pony Mail

Incubator

2016-05-27

1979

False

1

True

2020-10-09

383

0,0,0

12

0

True

True

True

True

True

True

True

True

SDAP

Incubator

2017-10-22

1466

False

2

True

2020-10-09

383

0,0,0

14

0

True

True

True

True

True

False

False

False

Sedona

Incubator

2020-07-19

465

False

2

True

2020-10-08

384

0,0,0

10

0

True

True

True

True

True

True

True

True

ShenYu

Incubator

2021-05-03

177

False

1

True

2021-06-24

125

0,0,3

26

0

True

False

True

False

True

True

True

True

Spot

Incubator

2016-09-23

1860

True

3

True

2020-10-09

383

0,0,0

16

0

True

True

True

True

True

True

True

True

StreamPipes

Incubator

2019-11-11

716

False

3

True

2021-07-22

97

0,1,6

18

7

True

True

True

True

True

True

True

True

Teaclave

Incubator

2019-08-20

799

False

1

True

2020-11-08

353

0,0,0

19

0

True

False

True

True

True

True

True

True

Toree

Incubator

2015-12-02

2156

False

2

True

2020-07-19

465

0,0,0

10

3

True

True

True

True

True

True

True

True

Training

Incubator

2019-02-21

979

False

2

True

2019-02-28

972

0,0,0

15

0

True

True

True

True

True

True

True

True

Tuweni

Incubator

2019-03-25

947

False

2

True

2020-10-08

384

0,0,0

14

0

True

True

True

True

True

True

True

True

Wayang

Incubator

2020-12-16

315

False

3

True

2021-01-22

278

0,0,0

11

0

True

False

True

True

True

True

True

False

YuniKorn

Incubator

2020-01-21

645

False

1

True

2021-09-23

34

2,4,5

25

6

True

True

True

True

True

True

True

True

Podling

Sponsor

A

B

C

D

E

F

G

H

I

J

K

L

M

N

O

P

Q

R

Definitions, Notes, and References

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

Podling

The name of each podling is linked to a podling clutch analysis page. If your podling is in incubation, but is missing from the Clutch table, then it still needs to be added to the content/podlings.xml file. See the mentor’s guide. Clutch also generates the Projects page from content/podlings.xml.

Sponsor

Usually the Incubator sponsors podlings. Occasionally Apache Top Level Projects (TLPs) sponsor podlings. The sponsor is chosen on the proposal. Set the value in the content/podlings.xml entry for the podling.

A: Start Date

This is the date the podling started. Usually this is the date the podling proposal vote passed on the Incubator mailing list. Set this in the content/podlings.xml entry for the podling.

B: Elapsed Days

This is the number of days since the start date. This is color coded according to the normal timeline of a podling. <3, <12, <18, <24, >24 months. We may adjust these levels to better fit currently-observed cycles.

C: Reporting Monthly

For the first three months podlings report monthly. If the podling misses a report, it returns to the monthly-reporting requirement until it reports again.

D: Reporting Group

Which months the podling reports: 1 = January, April, July, October; 2 = February, May, August, November; 3 = March, June, September, December. Note that the report process for a month begins at the end of the prior month. The IPMC chair sends out the reporting schedule on a monthly basis, and reminders to each podling’s dev list.

E: Has Status File

Each podling maintains a status file in content/projects/(podling).xml which Clutch converts to a status page. Your mentor sets up the file and then the podling maintains it. The key part to maintain is the "News" section, where you announce New Committers, PPMC Members, and Releases. For greater detail, please see:

Click the link in the cell to view the current status page.

F: Status Update Date

The date the status page was last updated. Keep the Status Page up to date with frequent news about:

  • New Committers

  • New PPMC Members

  • New Releases

  • New Repositories

  • New Resources

G: Status Age

Days since the status page was last updated. The text color indicates when a podling is not keeping its status up to date. <2, <4, <9, >9 months.

H: Status Update Counts

Cumulative number of commits to the podling status file in the previous 2, 4, and 9 months

I: Number of Committers

The number of committers who have been approved to date. Taken from Whimsy via public project ldap. Maintained in Whimsy through the roster pages. Click the cell to view the public phone book.

J: Number of New Committers

The number of committers added since establishment. This count comes from the Status page "News" section. See guides on voting in new committers and new ppmc members.

K: Has a Code Repository

Indicates whether the podling has created a Gitbox or Subversion code repository. Projects may have multiple Gitbox repositories. Click the podling name in the first column to view all of the podling’s repositories. A podling coming to the ASF may need to request a migration or a new repository. The list of Gitbox repositories comes from Gitbox json.

L: Has Issue Tracker

Indicates whether the podling has an Issue Tracker. If the status file has an issue tracker link and the link is valid, there is a link to the tracker in the cell.

M: Has a Dev Mailing List

Indicates whether the podling has established a dev email list and archives. This comes from the status page, and Clutch confirms that it matches the usual naming pattern. If the list is available, the cell has a link to the mailbox archive podling dev list.

N: Has a Commits Mailing List

Indicates whether the podling has established a commits email list and archives. This comes from the status page, and Clutch confirms that it matches the usual naming pattern. If the list is available, the cell has a link to the mailbox archive podling commits list. Sometimes a podling will start by directing code repository and issue tracker notification emails to their dev list. This will often obscur meaningful conversation.

O: Has a Web Site

Podlings should maintain a website so the user community can find out information about the podling and The Apache Software Foundation. Here is the incubator’s website guide. If the website is not provided in the status file, Clutch tries to find it using the usual naming patterns.

If the website exists, the cell provides a link to it. Whimsy provides a periodic scan of podling websites which you can view here. The clutch process uses json data to add notes about website issues to the podling’s clutch analysis page under "Errata".

P: Has a Distribution Area

Indicates whether the podling has a directory in the incubator’s release distribution directory. If this exists, the cell provides a link.

Q: Has Release Signing Keys

Indicates whether the podling has a PGP "Signing KEYS" file in its distribution area. If this is present, the cell provides a link.

R: Has a Release in the Distribution Area

Indicates whether the podling has a release in their distribution area. Podlings must comply with Apache release and release distribution policies as modified by the Incubator.

If there is a podling release, the cell provides a link to the podling’s clutch analysis page’s release section.

Graduating

Once the Board has approved the podling’s graduation resolution, update your podling metadata in the content/podlings.xml file as you progress through graduation. Complete the tasks listed in the documentation, such as a final tidy of the status page. See Infrastructure steps for graduation.

Retirement

Once the Incubator PMC has agreed to a podling’s retirement, update the podling metadata and tidy the status page. If the podling is continuing development elsewhere, make sure to provide the new location. When this occurs chances are someone on the IPMC will handle these duties ad hoc.

Other Issues

Sometimes other issues are found which are listed below for:

  • batchee

  • joshua

  • toree

Assist with Incubation Steps

Clutch helps us all follow the process from the "Acceptance" phase onwards. Any committer to a podling can help with these steps. Don’t leave it all to your mentors, although there are some steps that only they can do.

Mentors

This list comes from the Projects in incubation summary table. The Mentors are ASF members or individuals recognized by the IPMC who have chosen to assist these projects. The best way to find mentors for a new project is during your Discuss and Proposal phases on the general@ mail list.

  1. Akira Ajisaka (aajisaka): Kyuubi

  2. Antoine Toulme (toulmean): Tuweni

  3. Atri Sharma (atri): ShenYu

  4. Benjamin Young (bigbluehat): Annotator

  5. Bernd Fondermann (berndf): Wayang

  6. Bikas Saha (bikas): Livy

  7. Bob Paulin (bob): MXNet

  8. Byung-Gon Chun (bgchun): Nemo

  9. Christofer Dutz (cdutz): StreamPipes, Training, Wayang

  10. Craig Russell (clr): BlueMarlin, Training

  11. Dave Fisher (wave): Heron, NLPCraft

  12. David Meikle (dmeikle): Flagon

  13. Davor Bonaci (davor): Liminal

  14. Duo Zhang (zhangduo): Kyuubi, Linkis, NuttX, Pegasus, ShenYu

  15. Evans Ye (evansye): NLPCraft

  16. Felix Cheung (felixcheung): AGE, Crail, Teaclave, Sedona, YuniKorn

  17. Flavio Paiva Junqueira (fpj): NuttX

  18. Francois Papon (fpapon): EventMesh, Hop

  19. Furkan Kamaci (kamaci): DataLab, Flagon, Teaclave, MXNet, NLPCraft, Tuweni

  20. George Percivall (percivall): Sedona

  21. Gordon King (garyw): Teaclave

  22. Henry Saputra (hsaputra): DataLab, Liminal

  23. Holden Karau (holden): YuniKorn

  24. Hyunsik Choi (hyunsik): Nemo

  25. Jake Farrell (jfarrell): Heron

  26. Jason Dai (jasondai): MXNet

  27. Jason Lowe (jlowe): YuniKorn

  28. Jean-Baptiste Onofré (jbonofre): BlueMarlin, brpc, EventMesh, Liminal, Livy, Nemo, Sedona, StreamPipes, InLong, Tuweni, Wayang

  29. Jean-Frederic Clere (jfclere): Milagro

  30. Jeff Zhang (zjffdu): Kyuubi

  31. Jianyong Dai (daijy): Hivemall, Teaclave

  32. Jincheng Sun (jincheng): ShenYu

  33. John D. Ament (johndament): Pony Mail

  34. Juan Pan (panjuan): AGE, brpc

  35. Jukka Zitting (jukka): PageSpeed

  36. Julian Feinauer (jfeinauer): StreamPipes

  37. Julian Hyde (jhyde): Crail, Hop

  38. Julien Le Dem (julien): Heron, Toree

  39. Junping Du (junping_du): BlueMarlin, EventMesh, Linkis, NuttX, InLong, YuniKorn

  40. Justin Mclean (jmclean): EventMesh, NuttX, ShenYu, StreamPipes, Training, InLong

  41. Jörn Rottmann (joern): SDAP

  42. Kenneth Knowles (kenn): StreamPipes

  43. Kevin A. McGrail (kmcgrail): brpc, Pegasus

  44. Kevin Ratnasekera (djkevincr): AGE, Heron, Hop, ShenYu

  45. Koji Sekiguchi (koji): Hivemall

  46. Konstantin I Boudnik (cos): DataLab, NLPCraft

  47. Lars Francke (larsfrancke): Training

  48. Lars George (larsgeorge): Wayang

  49. Leif Hedstrom (zwoop): PageSpeed

  50. Lewis John McGibbney (lewismc): Flagon

  51. Liang Chen (chenliang613): Liminal, Pegasus

  52. Lidong Dai (lidongdai): Linkis

  53. Liu Xun (liuxun): Pegasus

  54. Luciano Resende (lresende): Crail, Livy, Marvin-AI, Toree

  55. Markus Weimer (weimer): MXNet, Nemo

  56. Matt Sicker (mattsicker): Teaclave

  57. Maximilian Michels (mxm): Hop

  58. Ming Wen (wenming): Doris, Heron

  59. Mohammad Asif Siddiqui (asifdxtreme): NuttX

  60. Nick Kew (niq): Annotator, Milagro, PageSpeed

  61. P. Taylor Goetz (ptgoetz): DataLab, Heron

  62. Paul King (paulk): NLPCraft

  63. Raphael Bircher (rbircher): AGE

  64. Roman Shaposhnik (rvs): NLPCraft

  65. Ryan Blue (blue): Toree

  66. Saisai Shao (jshao): Linkis

  67. Shaofeng Shi (shaofengshi): Doris, Linkis

  68. Sharan Foga (sharan): Pony Mail

  69. Sijie Guo (sijie): InLong

  70. Suneel Marthi (smarthi): AGE

  71. Tim Allison (tallison): Flagon

  72. Tom Barber (magicaltrout): Hop

  73. Tommaso Teofili (tommaso): Annotator

  74. Trevor Grant (rawkintrevo): SDAP

  75. Uma Maheswara Rao G (umamahesh): BlueMarlin, Liminal, Spot

  76. Von Gosling (vongosling): AGE, BlueMarlin, brpc, EventMesh, Pegasus, Sedona

  77. Wei-Chiu Chuang (weichiu): YuniKorn

  78. Willem Ning Jiang (ningjiang): Doris, Kyuubi, ShenYu

  79. William Colen (colen): Marvin-AI

  80. Zhenxu Ke (kezhenxu94): MXNet

  81. Zhijie Shen (zjshen): Teaclave, InLong

Notes

Any Incubator committer can run 'clutch'. In the top-level of the SVN repos incubator/public/trunk SVN, do: './clutch2.sh' to re-generate the data files and Asciidoctor files for the clutch. This is all a part of the normal build in GIT: Incubator Git. See the Readme.

Clutch reads the source file for the projects currently in incubation table (i.e. content/podlings.xml), ensures that each new project has an entry, and adds some more attributes. Clutch then gathers some data from each project’s Status page and validates that certain resources are established and steps have been achieved.

Clutch output includes data files

Podling Clutch Analysis Page

The clutch analysis fills the data included on this page and creates an analysis for each podling that can be linked to from the podling name in the clutch table.

Description

  • The podling description from content/podlings.xml

  • The podling start date.

  • The date of the last update of project/status.xml.

  • The reporting cycle.

  • The number of committers and ppmc members. Indication if these are equal.

  • Mentor list including apache ids.

News

Copies the news from the podling status page

Resources

Listing of various podling resources

Project Website

Link to podling’s public website

Mailing lists
  • Developer mailing list archive

  • Commits mailing list archive

Issue Tracker

Link to issue tracker

Wiki

Link to wiki

Repositories
  • Detailed list of gitbox repos from infra’s ground truth for the podling.

  • Link to any subversion repository.

  • For each gitbox repos:

    • Gitbox link

    • Github link

    • Description

    • Number of commits

    • Date of last commit

Releases

Information about the podling’s release, harvested from the distribution area’s svn repository.

Current

Current releases:

  • Link to the signing key, if it exists.

  • Link to instructions on how to verify a release.

  • Release list is suppressed if there are no signing keys

  • For each release:

    • Download link using closer.lua

    • Signature link

    • Hash link

    • Size of the download file

    • Date that the release was added to the distribution area.

    • User who moved the release.

    • Revision in the svn repository.

Errata

Issues which may require further work.

  • Errata has a list of potential issues identified for the podling.

  • Critical issues are in bold.

  • Links to pages on how to resolve the issue.

  • Link to the whimsy podling site scan/

Data files

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).

  • One text file for each Reporting group listing the dev mail address of the podlings due to report in that group. (See report_due_1.txt, report_due_2.txt, and report_due_3.txt) These are used by the IPMC to send monthly report alert reminders.

  • podlings_graduated.txt - list of graduated podlings, one per line with start and end dates.

  • podlings_retired.txt - list of retired podlings, one per line with start and end dates.

Other Issues

Occasionally there are other issues, usually regarding podlings not cleaning up after their "graduation".

  • batchee: Has graduated, but still has remains on Incubator distribution mirrors. See help.

  • joshua: Has graduated, but still has remains on Incubator distribution mirrors. See help.

  • toree: Has a distribution filename missing the word "incubating/incubator". See help.

Further Notes

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 and the detailed pages from the point-of-view of encouragement and nurture.

Origin

The nest was becoming full. Some podlings were forgotten, rolled into dark corners. We created a new tool, "clutch", to assist with oversight of all podlings (gmane link is now missing). The clutch started 2008-10-19. (missing gmane link) There was prior list discussion. Also see INCUBATOR-78

Colour Scheme

The colours for the table were specifically chosen to take into account colour-blindness and general accessibility. See the email discussion that led to this: Re: Clutch color coding. 2008-12-04 http://s.apache.org/clutch_colour and see some testing notes and demonstrations.

Thanks again to: "Color Universal Design (CUD) - How to make figures and presentations that are friendly to Colorblind people." Masataka Okabe and Kei Ito. (http://jfly.iam.u-tokyo.ac.jp/color/