incubator-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mar...@apache.org
Subject svn commit: r1553723 - in /incubator/public/trunk/content/guides: release.xml releasemanagement.xml
Date Fri, 27 Dec 2013 19:20:03 GMT
Author: marvin
Date: Fri Dec 27 19:20:03 2013
New Revision: 1553723

URL: http://svn.apache.org/r1553723
Log:
Update release checklist.

Move the newly minted release checklist from the experimental release
guide to the main release guide, where it replaces an old checklist
filled with TODO items.  Keep the old anchor, but move the content to a
more prominent location, one level up in the hierarchy and towards the
top of the page.

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

Modified: incubator/public/trunk/content/guides/release.xml
URL: http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/release.xml?rev=1553723&r1=1553722&r2=1553723&view=diff
==============================================================================
--- incubator/public/trunk/content/guides/release.xml [utf-8] (original)
+++ incubator/public/trunk/content/guides/release.xml [utf-8] Fri Dec 27 19:20:03 2013
@@ -108,96 +108,10 @@ permanently by moving it from votes/$POD
 
     <section id='release-manifest-template'><title>Release Manifest Template</title>
       <p>
-Podling's typically start from the Incubator's <a href="release_manifest.txt">default
Release Manifest</a> template.
-Optionally, a custom template may be created by augmenting the default Manfest template with
additional review items.
+Podlings typically start from the Incubator's <a href="release_manifest.txt">default
Release Manifest</a> template,
+which contains a <a href="releasemanagement.html#check-list">checklist</a> of
review items.  Optionally, a custom
+template may be created by augmenting the default Manifest template with additional review
items.
       </p>
-
-      <p>
-Each review item in the default Manifest is either required by Foundation-wide policy and
would block a release by any
-Apache top-level project, or is required by Incubator <a
-href="http://incubator.apache.org/incubation/Incubation_Policy.html">policy</a>.
 A list of possible additional 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>
-      <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>
-2.1 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>

Modified: incubator/public/trunk/content/guides/releasemanagement.xml
URL: http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/releasemanagement.xml?rev=1553723&r1=1553722&r2=1553723&view=diff
==============================================================================
--- incubator/public/trunk/content/guides/releasemanagement.xml [utf-8] (original)
+++ incubator/public/trunk/content/guides/releasemanagement.xml [utf-8] Fri Dec 27 19:20:03
2013
@@ -140,6 +140,98 @@ available on auxiliary pages.
       </section>
     </section>
     
+    <section id='check-list'><title>Release Check List</title>
+      <p>
+Each review item in this list is either required by Foundation-wide policy and would block
a release by any Apache
+top-level project, or is required by Incubator <a
+href="http://incubator.apache.org/incubation/Incubation_Policy.html">policy</a>.
+      </p>
+
+      <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>
+2.1 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>
+
+      <p>
+A list of possible additional items is
+maintained on the <a href="http://wiki.apache.org/incubator/ReleaseChecklist">ReleaseChecklist</a>
wiki page.
+      </p>
+
+    </section>
+
     <section id='guidelines'><title>Guidelines</title>
         <!-- 
     	<p>
@@ -609,57 +701,6 @@ TODO: maybe be better in a time line
       </section>
     </section> 
     
-    <section id='check-list'><title>Check List</title>
-        <p>
-<strong>Note</strong> this is not intended to replace an understanding of the
release process.
-        </p>
-        <ul>
-            <li><a href='#glossary-packages'>Packages</a>
-                <ul>
-                    <li>Check that compressed artifacts <a href='#best-practice-formats'>unpack
correctly</a></li>
-                    <li>Check that the documentation is readable</li>
-                    <li>Check <a href='best-practice-distributing-libraries'>distributed
libraries</a>
-                    	<ul>
-	                    	<li>Check licenses for libraries are distributed together with
any applicable 
-	                    	<a href='best-practice-notice'>NOTICEs</a> TODO: link</li>
-                    		<li>Check that licenses comply with incubator policy TODO: link</li>
-                    		<li>Check that licenses comply with project policy TODO: link</li>

-                    		<li>Check that LICENSE and NOTICE documents contain required
sections</li>
-                    		<li>Check that any cryptographic dependencies satisfy export
regulations</li>
-                    	</ul>
-                    </li>
-                    <li>Check copyright notices:
-                    	<ul>
-	                    	<li>Licenses missing from source files</li>
-	                    	<li>Source files with other licenses which are not mentioned
in LICENSE</li>
-	                    	<li>Check current policy on headers that all comply</li>
-                    	</ul>
-                    </li>
-                    <li>Check incubator requirements
-                    	<ul>
-                    		<li>Check <a href='#notes-disclaimer'>disclaimer</a>
is distributed TODO: link</li>
-                    	</ul>
-                    </li>
-                </ul>
-            </li>
-            <li><a href='#glossary-source-package'>Source Package</a>
-            	<ul>
-            		<li>Check build instructions exist and that source <a href='#best-practice-source-build'>builds</a>
-            		using these instructions</li>
-            		<li>Check <a href='glossary-license-headers'>license headers</a>

-            		are <a href='notes-license-headers'>correctly applied</a></li>
-            		<li>Check for <a href='#best-practice-source'>version control</a>
files</li>
-            		<li>Check that source is exported from tag</li>
-            	</ul>
-            </li>
-         	<li>OpenPGP keys
-         		<ul>
-         			<li>Check KEYS file contains signing key</li>
-         			<li>Check key has been uploaded to regular public key servers</li>
-         		</ul>
-         	</li>
-        </ul>
-    </section>
     <section id='rules'><title>Rules</title>
         <p>
 Every incubator release is also an Apache release. So Apache policy must be followed. 



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


Mime
View raw message