blob: b02381e15603b4d00c6ccd9cdf164a163291d914 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" href="./style/bootstrap-1-3-0-min.css" type="text/css" />
<link rel="stylesheet" href="./style/style.css" type="text/css" />
<link rel="alternate" title="general@incubator.apache.org Archives" type="application/atom+xml" href="http://mail-archives.apache.org/mod_mbox/incubator-general/?format=atom" />
<title>The Story of a Podling - Apache Incubator</title>
</head>
<body>
<div class="container">
<div class="row">
<div class="span12">
<a href="http://www.apache.org/"><img src="http://incubator.apache.org/images/asf_logo_wide_small.png" alt="The Apache Software Foundation" border="0" style="margin-top: 2px" width="62%"/></a>
</div>
<div class="span4">
<a href="http://incubator.apache.org/"><img src="./images/egg-logo2.png" alt="Apache Incubator" border="0"/></a>
</div>
</div>
<div class="row"><div class="span16"><hr noshade="noshade" size="1"/></div></div>
<div class="row">
<div class="span4">
<form action="http://www.google.com/search" method="get">
<input value="incubator.apache.org" name="sitesearch" type="hidden"/>
<input size="20" name="q" id="query" type="text" value="search..."
onclick="if(this.value == 'search...') {this.value = ''}"/>
<input name="Search" value="Go" type="submit"/>
</form>
<div class="menuheader">General</div>
<menu compact="compact">
<li><a href="./index.html">Welcome</a></li>
<li><a href="./incubation/Process_Description.html">Incubation Overview</a></li>
<li><a href="./incubation/Incubation_Policy.html">Incubation Policy</a></li>
<li><a href="./guides/index.html">Incubation Guides</a></li>
<li><a href="./incubation/Roles_and_Responsibilities.html">Roles and Responsibilities</a></li>
<li><a href="./faq.html">General FAQ</a></li>
<li><a href="http://wiki.apache.org/incubator">Incubator Wiki</a></li>
<li><a href="./whoweare.html">Who We Are</a></li>
<li><a href="./sitemap.html">Site Map</a></li>
</menu>
<div class="menuheader">Status</div>
<menu compact="compact">
<li><a href="./projects/index.html">Project List</a></li>
<li><a href="./clutch.html">Clutch Report</a></li>
<li><a href="./ip-clearance/index.html">IP Clearance</a></li>
<li><a href="./history/index.html">Incubator History</a></li>
</menu>
<div class="menuheader">Entry Guides</div>
<menu compact="compact">
<li><a href="./guides/proposal.html">Proposal Guide</a></li>
</menu>
<div class="menuheader">Podling Guides</div>
<menu compact="compact">
<li><a href="./guides/committer.html">Podling Committers</a></li>
<li><a href="./guides/ppmc.html">Podling PMC (PPMC)</a></li>
<li><a href="./guides/mentor.html">Podling Mentor</a></li>
<li><a href="./guides/releasemanagement.html">Podling Releases</a></li>
<li><a href="./guides/branding.html">Podling Branding/Publicity</a></li>
<li><a href="./guides/sites.html">Podling Websites</a></li>
<li><a href="./guides/graduation.html">Graduation</a></li>
<li><a href="./guides/retirement.html">Retirement</a></li>
</menu>
<div class="menuheader">Other Guides</div>
<menu compact="compact">
<li><a href="./guides/participation.html">Participation</a></li>
<li><a href="./faq.html">General FAQ</a></li>
<li><a href="./guides/pmc.html">Incubator PMC (IPMC)</a></li>
<li><a href="./guides/chair.html">IPMC Chair</a></li>
<li><a href="./guides/lists.html">Mailing Lists</a></li>
<li><a href="./guides/website.html">Incubator Website</a></li>
</menu>
<div class="menuheader">ASF</div>
<menu compact="compact">
<li><a href="http://www.apache.org/foundation/how-it-works.html">How Apache Works</a></li>
<li><a href="http://www.apache.org/dev/">Developer Documentation</a></li>
<li><a href="http://www.apache.org/foundation/">Foundation</a></li>
<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsor Apache</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
</menu>
<!-- start Ads Server -->
<iframe src="http://www.apache.org/ads/buttonbar.html"
style="border-width:0; float: left" frameborder="0" scrolling="no"
width="135" height="265"></iframe>
<!-- end Ads Server -->
</div>
<div class="span12">
<h2 id='story'><img src="./images/redarrow.gif" />DRAFT - The Story of a Podling</h2>
<div class="section-content">
<p><b>This is just a draft for now...still a work in progress</b></p>
<p>
This is an informational overview of the life of a podling, from proposal to graduation.
</p>
<p>
It is intended for people considering incubating their project at the ASF, or people joining podlings,
as a single page that gives an overview of the incubation process, without going into too much detail.
</p>
<p>
Links to examples of proposals, discussions etc. are provided
to give a more concrete overview of what happens during incubation.
</p>
<p>
We won't include many details - the goal is to keep this short,
so that you consume it in about ten minutes.
</p>
<h3 id='foo'>Proposal</h3>
<div class="section-content">
<p>
The first step towards incubation is to create a proposal for the Incubator.
Examples like the <a href="http://wiki.apache.org/incubator/ClerezzaProposal">Clerezza</a> and
<a href="http://wiki.apache.org/incubator/FlexProposal">Flex</a> proposals will
give you a feel for what to put in there.
</p>
<p>
Creating the proposal will usually raise a number of questions about your future
podling, and it's good to already find an ASF <a href="http://incubator.apache.org/incubation/Roles_and_Responsibilities.html#Champion">champion</a>
at this stage,
to answer any questions that you might have or make the necessary contacts.
</p>
<p>
Once your proposal is ready and you have decided to go forward, you can add it
to the <a href="http://wiki.apache.org/incubator/">wiki</a> and send a [PROPOSAL]
message to the general@a.o list. Incubator PMC members can then give their feedback
to help refine the proposal before voting upon it.
See the <a href="http://markmail.org/message/5udhowlggdmjsmd6">Flex discussion</a> for an example.
</p>
</div>
<h3 id='foo'>Mentors and initial committers</h3>
<div class="section-content">
<p>In general 2-3 incubation mentors, either ASF members of Incubator PMC members</p>
<p>Need to decide how to manage the list of initial committers</p>
</div>
<h3 id='foo'>Incubator entry vote</h3>
<div class="section-content">
<p>Starts when discussion is done</p>
<p>Point to Flex vote</p>
<p>72 hours as per ASF voting rules</p>
<p>Usually driven by the champion</p>
<p>Usually not contentious, as the previous phases help build consensus</p>
</div>
<h3 id='foo'>Podling creation</h3>
<div class="section-content">
<p>Point to Flex jira issues</p>
<p>Driven by the champion</p>
</div>
<h3 id='foo'>Initial code and trademarks</h3>
<div class="section-content">
<p>If initial code is being donated you need software grants</p>
<p>If the donated code has multiple owners or contributors, you might need to chase them down at this point, or omit the code for which you cannot get permission</p>
<p>Any relevant trademarks should be donated at this point</p>
</div>
<h3 id='foo'>First release</h3>
<div class="section-content">
<p>
It's good to make a first release early, even if it's not of great technical quality.
From the Incubator's point of view, the release only has to fulfill the ASF's release requirements, which are primarily legal.
Whether the product is good or useful software doesn't matter at this stage.
</p>
<p>
Learning the ASF's legal rules and customs, adapting the codebase to conform to them, and getting that first release past the Incubator PMC voting stage can be hard, so it's a good idea to tackle this task during the initial burst of energy as incubation begins.
A secondary goal of making an early release is to document the podling's release process (link to Flex or Sling process), so that subsequent releases are easy and fast and people who are not core developers may serve as release managers.
</p>
</div>
<h3 id='foo'>Community growth</h3>
<div class="section-content">
<p>
To graduate, a podling has to demonstrate its ability to grow its community. In practice, this means attracting and electing new committers and PPMC members.
Starting early on this helps. (TODO: reading list, Jukka's posts?)
</p>
<p>
TODO: demonstrate openness/diversity
</p>
</div>
<h3 id='foo'>Exit discussions</h3>
<div class="section-content">
<p>Incubation can proceed in unexpected directions - the standard exit is to become a TLP but that's not the only possibility (join a TLP, go elsewhere, retire, ...)
- which are not necessarily failures.
</p>
<p>Discuss with the mentors and community based on the graduation criteria (link - Clerezza discussion?)</p>
</div>
<h3 id='foo'>Graduation vote</h3>
<div class="section-content">
<p>If graduating to TLP, First step is to create the board resolution, discuss who's on the new PMC (link to flex as one example),
it's good to have at least one ASF member in there.</p>
<p>Community votes first, then IPMC.</p>
<p>Point to policy + example votes</p>
</div>
<h3 id='foo'>Board resolution</h3>
<div class="section-content">
<p>The Incubator PMC acceptance vote is only a recommendation for the board to accept the new project.</p>
<p>The new TLP only exists once the board approves the resolution to establish it. This is usually announced right after the board meeting, and the new PMC chair
can then start the mechanics of establishing the TLP.</p>
</div>
<h3 id='foo'>Champagne!</h3>
<div class="section-content">
<p>Congratulations - at this point the new TLP is a full blown Apache project, and the newly created PMC is fully in charge of its destiny.</p>
</div>
</div>
</div>
</div>
<div class="row"><div class="span16"><hr noshade="noshade" size="1"/></div></div>
<div class="row">
<div class="span16 footer">
Copyright &#169; 2009-2016 The Apache Software Foundation<br />
Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>
Apache Incubator, Apache, the Apache feather logo, and the Apache Incubator project logo are trademarks of The Apache Software Foundation.
</div>
</div>
</div>
</body>
</html>