incubator-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mar...@apache.org
Subject svn commit: r1550056 - /incubator/public/trunk/content/guides/release.xml
Date Wed, 11 Dec 2013 05:50:39 GMT
Author: marvin
Date: Wed Dec 11 05:50:39 2013
New Revision: 1550056

URL: http://svn.apache.org/r1550056
Log:
Flesh out the Release Procedure (formerly Manifest Usage).

Modified:
    incubator/public/trunk/content/guides/release.xml

Modified: incubator/public/trunk/content/guides/release.xml
URL: http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/release.xml?rev=1550056&r1=1550055&r2=1550056&view=diff
==============================================================================
--- incubator/public/trunk/content/guides/release.xml [utf-8] (original)
+++ incubator/public/trunk/content/guides/release.xml [utf-8] Wed Dec 11 05:50:39 2013
@@ -23,47 +23,52 @@ limitations under the License.
     <title>Experimental Release Guide (DRAFT)</title>
   </properties>
   <body>
-    <section id='status'><title>DRAFT STATUS</title>
+    <section id='status'><title>DRAFT, EXPERIMENTAL STATUS</title>
       <p style="color:red">
 <strong>This document is part of a proposal currently being refined and is
 not yet ready for use.</strong>
       </p>
+      <p>
+This document describes an experiment in which only selected podlings may take part.  The
procedure for joining the
+experiment is (will be) described in the <a
+href="http://incubator.apache.org/incubation/Incubation_Policy.html#Releases">incubation
policy</a> page.
+      </p>
     </section>
+
     <section id='intro'><title>Experimental Release Guide (DRAFT)</title>
           <section id='TOC'><title>Contents</title><toc/></section>
     </section>
     
-    <section id='release-manifest-template'><title>Release Manifest Template</title>
+    <section id="manifest-usage"><title>Release Procedure</title>
+      <p>
+Once a release candidate is ready, the <a
+href="http://www.apache.org/dev/release-publishing.html#release_manager">Release Manager</a>
should create a <a
+href="http://incubator.apache.org/guides/release.html#release-manifest-template">Release
+Manifest</a> at http://svn.apache.org/repos/asf/incubator/public/trunk/votes/$PODLING
and fill in all initial fields.
+      </p>
       <p>
-The release manifest template is available <a
-href="release_manifest.txt">here</a>.
+A [VOTE] thread should be started on the podling's dev list in accordance with <a
+href="http://incubator.apache.org/incubation/Incubation_Policy.html#Releases">Incubator
policy on releases</a>.  The
+email kicking off the [VOTE] should contain a link URL for the Manifest.  While the [VOTE]
is in progress, reviewers
+update the Manifest accordingly.  Should the dev list [VOTE] pass, a [VOTE] on general@incubator
should be called, again
+in accordance with Incubator release <a
+href="http://incubator.apache.org/incubation/Incubation_Policy.html#Releases">policy</a>
and again referencing the
+Manifest URL.
+      </p>
+      <p>
+Once the voting process concludes -- regardless of success or failure -- the Release Manager
should archive the Manifest
+permanently by moving it from votes/$PODLING/ to votes/$PODLING/archive/.
       </p>
     </section>
-    <section id="manifest-usage"><title>Release Manifest Usage</title>
-      <ol>
-        <li>
-Once a release is ready, create such a manifest at
-http://svn.apache.org/repos/asf/incubator/public/trunk/votes/$PODLING
-        </li>
-        <li>
-Drive the vote on the podling's dev list, reviewers update the manifest
-accordingly.
-        </li>
-        <li>
-Bring the vote to general@incubator.a.o, pointing to the existing manifest.
-        </li>
-        <li>
-For both votes, +1s in the manifest are added to the [VOTE] thread votes.
-        </li>
-        <li>
-A given (to be defined) number of documented reviews in the manifest is
-required for the release to be approved.
-        </li>
-        <li>
-Release manifests are kept forever in svn, moved to an "archive" subfolder of
-$PODLING to make their status clear. 
-        </li>
-      </ol>
+
+    <section id='release-manifest-template'><title>Release Manifest Template</title>
+      <p>
+Podlings may start from the Incubator's <a href="release_manifest.txt">default
+Release Manifest</a> template or may customize a template to meet their own
+needs.  A list of suggested additional review items is maintained on the <a
+href="http://wiki.apache.org/incubator/ReleaseChecklist">ReleaseChecklist</a>
+wiki page.
+      </p>
     </section>
 
     <section id='review-items'><title>Review Item Explanations</title>



---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
For additional commands, e-mail: cvs-help@incubator.apache.org


Mime
View raw message