incubator-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mar...@apache.org
Subject svn commit: r1549372 - in /incubator/public/trunk/content/guides: release.xml release_manifest.txt
Date Mon, 09 Dec 2013 02:58:11 GMT
Author: marvin
Date: Mon Dec  9 02:58:10 2013
New Revision: 1549372

URL: http://svn.apache.org/r1549372
Log:
Migrate the release checklist proposal from the wiki.

These documents are part of a proposal currently being refined and are
not yet ready for use.  They are prominently labeled as such.

Previous home: http://wiki.apache.org/incubator/ReleaseChecklist

Added:
    incubator/public/trunk/content/guides/release.xml
    incubator/public/trunk/content/guides/release_manifest.txt

Added: incubator/public/trunk/content/guides/release.xml
URL: http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/release.xml?rev=1549372&view=auto
==============================================================================
--- incubator/public/trunk/content/guides/release.xml (added)
+++ incubator/public/trunk/content/guides/release.xml [utf-8] Mon Dec  9 02:58:10 2013
@@ -0,0 +1,168 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Licensed 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.
+-->
+
+<!DOCTYPE document
+[
+<!ENTITY root-path   '..'> <!-- The path to the incubator root -->
+]>
+
+<document>
+  <properties>
+    <title>Experimental Release Guide (DRAFT)</title>
+  </properties>
+  <body>
+    <section id='status'><title>DRAFT 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>
+    </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>
+      <p>
+The release manifest template is available <a
+href="release_manifest.txt">here</a>.
+      </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>
+
+    <section id='review-items'><title>Review Item Explanations</title>
+      <dl>
+
+        <dt>
+1.1 Checksums and PGP signatures are valid.
+        </dt>
+        <dd>
+See the <a
+href="http://www.apache.org/dev/release-signing.html#basic-facts">Release
+Signing</a> dev documentation.
+        </dd>
+
+        <dt>
+1.2 Each expanded source archive matches the corresponding SCM tag.
+        </dt>
+        <dd>
+(Strike?  See <a
+href="http://markmail.org/message/2ncepopzgnshtyd6">http://markmail.org/message/2ncepopzgnshtyd6</a>
+vs <a
+href="http://incubator.apache.org/guides/releasemanagement.html#best-practice-reproducability">http://incubator.apache.org/guides/releasemanagement.html#best-practice-reproducability</a>)
+        </dd>
+
+        <dt>
+2.1 Build instructions are provided, unless obvious.
+        </dt>
+        <dd>
+(Not documented as required elsewhere AFAICT.  Strike?)
+        </dd>
+
+        <dt>
+2.2 Build is successful including automated tests.
+        </dt>
+        <dd>
+The expanded source archive is expected to <a
+href="http://www.apache.org/dev/release.html#what-must-every-release-contain">
+build and pass tests</a>.
+        </dd>
+
+        <dt>
+3.1 DISCLAIMER is correct, filenames include "incubating".
+        </dt>
+        <dd>
+See the <a
+href="http://incubator.apache.org/guides/branding.html#disclaimers">Podling
+Branding Guide</a>.
+        </dd>
+
+        <dt>
+3.2 Top-level LICENSE and NOTICE are correct for each distribution.
+        </dt>
+        <dd>
+See the <a href="http://www.apache.org/dev/licensing-howto.html">Licensing
+How-To</a>, plus various pages under <a
+href="http://www.apache.org/legal">Legal Affairs</a>.
+        </dd>
+
+        <dt>
+3.3 All source files have license headers where appropriate.
+        </dt>
+        <dd>
+See the <a href="http://www.apache.org/legal/src-headers.html">ASF Source
+Header and Copyright Notice Policy</a>.
+        </dd>
+
+        <dt>
+3.4 The provenance of all source files is clear (ASF or software grants).
+        </dt>
+        <dd>
+See the <a
+href="http://incubator.apache.org/guides/mentor.html#initial-ip-clearance">IP
+clearance</a> section of the Mentor's guide, as well as the <a
+href="http://incubator.apache.org/incubation/Incubation_Policy.html#Releases">Releases</a>
+section of the Incubator's policy page.
+        </dd>
+
+        <dt>
+3.5 Dependencies licenses are ok as per http://apache.org/legal/
+        </dt>
+        <dd>
+See <a href="http://www.apache.org/legal/resolved.html">ASF Legal Previously
+Asked Questions</a>.
+        </dd>
+
+        <dt>
+3.6 Release consists of source code only, no binaries.
+        </dt>
+        <dd>
+Each Apache release <a
+href="http://www.apache.org/dev/release-publishing.html#valid">must contain a
+source package</a>.  This package may not contain compiled components (such as
+"jar" files) because compiled components are not open source, even if they
+were built from open source.
+        </dd>
+
+      </dl>
+    </section>
+
+  </body>
+</document>
+

Added: incubator/public/trunk/content/guides/release_manifest.txt
URL: http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/release_manifest.txt?rev=1549372&view=auto
==============================================================================
--- incubator/public/trunk/content/guides/release_manifest.txt (added)
+++ incubator/public/trunk/content/guides/release_manifest.txt Mon Dec  9 02:58:10 2013
@@ -0,0 +1,65 @@
+************************************************************************
+DRAFT STATUS -- This document is part of a proposal currently being
+refined and is not yet ready for use.
+************************************************************************
+
+== Apache Release Manifest =============================================
+Project: 
+Release: 
+Release manager: 
+Creation date: XXXX-XX-XX 
+Status: (vote in progress/canceled/released)
+TODO: add link to an explanation page under http://incubator.apache.org
+
+== Reviewers and release votes =========================================
+
+
+
+== Contents =============================================================
+
+
+
+== Review Items =========================================================
+Use "RI m.n" to refer to these elsewhere.
+
+Reviewers sign each item with their Apache ID to indicate that they have
+reviewed and found it ok. 
+
+Reviewers don't need to look at all items, as long as there's sufficient 
+coverage of each item the release can go out.
+
+Comments signed with a reviewer's Apache ID are also fine.
+
+1.1 Checksums and PGP signatures are valid.
+    Reviewers: 
+
+1.2 Each expanded source archive matches the corresponding SCM tag.
+    Reviewers: 
+
+2.1 Build instructions are provided, unless obvious.
+    Reviewers: 
+
+2.2 Build is successful including automated tests.
+    Reviewers: 
+
+3.1 DISCLAIMER is correct, filenames include "incubating".
+    Reviewers: 
+
+3.2 Top-level LICENSE and NOTICE are correct for each distribution.
+    Reviewers: 
+
+3.3 All source files have license headers where appropriate.
+    Reviewers: 
+
+3.4 The provenance of all source files is clear (ASF or software grants).
+    Reviewers: 
+
+3.5 Dependencies licenses are ok as per http://apache.org/legal/
+    Reviewers: 
+
+3.6 Release consists of source code only, no binaries.
+    Reviewers: 
+
+== Additional Notes =====================================================
+(free-form reviewer's notes)
+



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


Mime
View raw message