Guide to Retirement

Abstract

The intent of this document is to help mentors to understand the process of retirement.

What is Retirement?

A retired project is a project which has been closed down by the PPMC or by the IPMC for various reasons. It is not longer developed at the Apache Incubator and does not have any other duties.

It's important to view this process as being the retirement of the podling community, not the code. It should not be implied that the code is not for use - just that it has no community. The source code of a retired project is available in SVN, when the copyright requirements are fullfilled. This is indicated through the incubator status page.

Before following the retirement steps, the remaining developers of the project should be informed and vote should happen on the projects dev list. After the vote, the IPMC must vote on the general list to retire the project.

With that said, the ASF is not governed by votes, it is governed by consensus. It's important to note that in votes people often pile on without doing the appropriate background work (a +/-1 is easier than discussing the various options to reach consensus).

Votes in the ASF are usually used to confirm consensus that has already been achieved through discussion. So, in addition to supporting the suggestion to have a [DISCUSS] thread before a [VOTE] thread the following the following are guidelines with respect to podling retirement:

  1. If the PPMC unanimously recommends retirement, it gets retired. No need for a VOTE, just notify the IPMC, leave for 72 hours minimum and retire it.
  2. If the mentors say it should be retired but the PPMC does not unanimously agree then the podling should seek to recruit new mentors. No need to VOTE, just get on with it.
  3. If there insufficient mentors willing to continue working with the project then the IPMC has a problem to address on a case by case basis. The shepherd role ensures that these cases are spotted during the reporting process. If necessary a [DISCUSS] thread can be started and a sensible plan is developed (which may include a VOTE to retire, at this point there should be no -1's as a -1 needs to be backed by a willingness to act and thus this should have been surfaced in case 2) above.

Note, this is exactly what happens with board oversight of TLPs, the language and role titles change but in general the board merely implement the wishes of the community. The only time the board makes an actual decision is when the community is breaking down for some reason. This is done on a case by case basis after spending time trying to understand the situation (case 3) above)

Retirement Cleanup Steps

Do the following steps to retire a project. Note also that there might be some other steps not yet documented (for example, see INCUBATOR-100).

The user accounts of the projects committers do not need to be removed.