The Apache Software Foundation
Apache Incubator

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.

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.

In some cases the developers of a project might be opposed to retirement, while the IPMC is in favour because its members cannot see a succesfull graduation now or in future. In this case the IPMC decides about the retirement.

Steps to retirement

Follow the following steps to retire a project:

  • Has the copyright checkbox of the incubator status page been checked off? If not, try to resolve it. If it cannot be resolved, source code must be removed from SVN.
  • Update the incubator status page with the message: "2006-06-24 Project requested to be withdrawn from incubation."
  • Update the podling status in the file content/podlings.xml to "retired"
  • Also add the "enddate" attribute to document when the project retired.
  • Update the project DOAP file
  • Make SVN readonly (ASFInfra JIRA)
    • Remove entries from asf-authorizaton - this makes the directory rw to the Incubator PMC.
    • Add entries to asf-mailer.conf and send mail to cvs at incubator.apache.org
  • If JIRA: Move the JIRA project to a Retired category and Retired (read-only) permissions (ASFInfra JIRA)
  • If Bugzilla: Close the project in Bugzilla so new issues cannot be created (ASFInfra JIRA)
  • Make wiki readonly (ASFInfra JIRA)
  • Turn off automatic builds (ASFInfra JIRA)
  • Close the mailinglist (and remove them from the incubator status page)
  • Remove from reporting schedule
  • Indicate the podling is closed down in the next board report
  • Announce completeness on general@incubator.apache.org

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