Tasks for Creating an ASF Project

See the general document Procedures for Creating a Top-Level Project. This document assumes that the PMC/TLP infrastructure is already in place and is meant for when a new codebase joins a PMC.

Of course there are some tasks that can only be done by the Infrastructure team. Discuss the options on your dev|pmc mailing list first and be clear about what you want to be done. Compile those into an email message and send it to the infrastructure@apache.org mailing list. To help facilitate your request, you are also requested to file an issue tracker request with this information.

Items that will require assistance of Infrastructure team

The following is intended to be a standard form for helping to setup a new project entering incubation or for a project moving to top-level. It is an evolving document - please patch if you discover more. Not all entries will be valid. For example, in almost all cases only the -dev mailing list will be created during incubation. It would be rare to also create a -users list for a new project. You do not need to specify every detail. The infrastructure people already know about many background things, e.g. DNS entries, unix groups, etc. Prepare the following text by discussing with your developers. When you have the necessary decisions, then use this template to send your request to infrastructure@apache.org Other tasks, such as Issue Tracker and Wiki, are separately described below.

-------------------------------- snip --------------------------------
The $TLP PMC has agreed to accept the $PROJECT project for incubation.
To aid in the process, would infrastructure please do the following:

#=======================================
[1] Mailing List (i) addresses 

  I.   $PROJECT-dev@$TLP.apache.org
  II.  $PROJECT-users@$TLP.apache.org
  III. $PROJECT-commits@$TLP.apache.org

(ii) remote moderators ...
  Note: At least two, preferably world-wide coverage.

(iii) archives 
  mbox
  I.     http://$TLP.apache.org/mail/$PROJECT/dev/YYYYMM.gz
  II.    http://$TLP.apache.org/mail/$PROJECT/users/YYYYMM.gz
  III.   http://$TLP.apache.org/mail/$PROJECT/commits/YYYYMM.gz

(iv) options 

  I.   Reply-To: Header       [X] yes   [ ] no
    NOTE: $PROJECT-commits@$TLP.apache.org -> $PROJECT-dev@$TLP.apache.org
  II.  Message Trailer        [ ] yes   [X] no

#=======================================
[2] Source Tracker

(i) Subversion

     The PMC chair can create the project namespace (svn mkdir) and modify the
     asf-authorization file accordingly.

     Just tell us about any special requirements - i.e. mailing lists configs.

#=======================================
[3] Initial Committer list 

... 

#=======================================
[4] Snapshots

Create directory http://people.apache.org/snapshots/$TLP
Tweak the script that creates the snapshots (~apmail/bin/taritup).
-------------------------------- snip --------------------------------

Items that the project PMC can do

There are various things that your project can do to aid the establishment of your project resources. If your project committers do not have the permissions, then your PMC's ASF members would.

#=======================================
Wiki

If you want a Wiki, then see
http://wiki.apache.org/general/HowToMakeWikiAdminRequests

#=======================================
Issue Tracker

There is a choice between Jira and Bugzilla

(i) Bugzilla URL:
http://issues.apache.org/bugzilla/buglist.cgi?product=$PROJECT 

Send email to infrastructure ...

Product description:
Components:

(ii) Jira 

 Follow the separate instructions at
 http://wiki.apache.org/old/JIRA

 per-separately releasable package
 Project Name:
 Project Lead:
 Preferred Project Abbreviation(s):
 A list of Jira accounts to mark as project developers
 ...
 [if necessary, provision can be made to have admins list
  different from developer list]

As an example, although Jakarta Commons is a single source code module in the source
repository, each project would be a separate Jira project, although sharing a common
permissions schema. 

After the project is setup in Jira, the project's PMC will be responsible
for the configuration of its own settings: components, versions, etc.

#=======================================
Apache Project Listing

If you want your project included in the Apache Projects list at: http://projects.apache.org/
then you need to ensure that the TLP details are included in:

http://svn.apache.org/repos/asf/infrastructure/site-tools/trunk/projects/pmc_list.xml
and
http://svn.apache.org/repos/asf/infrastructure/site-tools/trunk/projects/data_files/TLP.rdf

You can then create and submit the project DOAP as described in:

http://projects.apache.org/create.html
 

#=======================================
Apache Gump

If your project already uses Gump, then the move will mean that you need to
adjust your Gump descriptor in SVN.

#=======================================