click-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sa...@apache.org
Subject svn commit: r731643 - in /incubator/click/trunk/click/documentation/docs/developer-guide: developer-guide.html releasing-subprojects.html releasing.html
Date Mon, 05 Jan 2009 18:26:23 GMT
Author: sabob
Date: Mon Jan  5 10:26:22 2009
New Revision: 731643

URL: http://svn.apache.org/viewvc?rev=731643&view=rev
Log:
added release guide for subprojects

Added:
    incubator/click/trunk/click/documentation/docs/developer-guide/releasing-subprojects.html
Modified:
    incubator/click/trunk/click/documentation/docs/developer-guide/developer-guide.html
    incubator/click/trunk/click/documentation/docs/developer-guide/releasing.html

Modified: incubator/click/trunk/click/documentation/docs/developer-guide/developer-guide.html
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/documentation/docs/developer-guide/developer-guide.html?rev=731643&r1=731642&r2=731643&view=diff
==============================================================================
--- incubator/click/trunk/click/documentation/docs/developer-guide/developer-guide.html (original)
+++ incubator/click/trunk/click/documentation/docs/developer-guide/developer-guide.html Mon
Jan  5 10:26:22 2009
@@ -49,6 +49,9 @@
                 <a href="releasing.html">Creating a Release</a>
             </li>
             <li>
+                <a href="releasing-subprojects.html">Creating a Release for Subprojects</a>
+            </li>
+            <li>
                 <a href="contributing.html">Contributing</a>
             </li>
         </ul>

Added: incubator/click/trunk/click/documentation/docs/developer-guide/releasing-subprojects.html
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/documentation/docs/developer-guide/releasing-subprojects.html?rev=731643&view=auto
==============================================================================
--- incubator/click/trunk/click/documentation/docs/developer-guide/releasing-subprojects.html
(added)
+++ incubator/click/trunk/click/documentation/docs/developer-guide/releasing-subprojects.html
Mon Jan  5 10:26:22 2009
@@ -0,0 +1,122 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.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>
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+        <meta name="Author" content="Malcolm Edgar"/>
+        <meta name="description" lang="en" content="Apache Click Java web application
framework"/>
+        <meta name="keywords" lang="en" content="Apache Click, Click Framework, Java,
JEE, J2EE, web application framework, open source"/>
+        <title>Apache Click</title>
+        <link rel="stylesheet" type="text/css" href="../../help.css"/>
+        <style type="text/css">
+            th { text-align: left; }
+            td { vertical-align: top; white-space: nowrap; }
+        </style>
+    </head>
+    <body>
+
+        <h1>Creating a Release for Subprojects</h1>
+
+        This page documents the requirements for releasing a Click subproject.
+
+        <p/>
+        <b>Please note</b> this section is for committers only.
+
+        <h3>Prerequisites</h3>
+
+        Subprojects have the same prerequisites as Click. See <a href="releasing.html#prerequisites">here</a>
for details.
+
+        <h3>Release Procedure</h3>
+
+        Subproject releases should adhere to the following steps:
+
+        <ol>
+            <li>
+                Create the distribution using your favorite build tool e.g. Ant.
+            </li>
+            <li>
+                Create MD5 and SHA1 hashes of the distribution file.
+            </li>
+            <li>
+                Digitally sign the distribution, for example:
+                <pre class="codeConfig">gpg --armor --output ClickIDE-X.X.X-incubating.zip.asc
--detach-sig ClickIDE-X.X.X-incubating.zip</pre>
+            </li>
+            <li>
+                Upload the distribution to your account at <tt>people.apache.org</tt>
+                under the folder <tt>~/public_html/release/X.X.X</tt>, where
X.X.X
+                is the version number of the project.
+            </li>
+            <li>
+                Verify the digital signatures at <tt>people.apache.org</tt> to
+                ensure nothing went wrong with the upload.
+                <p/>
+                Please note if this is the first time you verify your key
+                at <tt>people.apache.org</tt>, you'll need to import your public
+                key first.
+                <p/>
+                Assuming your public key ID is '709F7561' and your key is available
+                from the public key server 'pgp.mit.edu', the following command
+                will import the key on <tt>people.apache.org</tt>:
+                <pre class="codeConfig">
+ssh people.apache.org
+gpg --keyserver pgp.mit.edu --recv-keys 709F7561
+</pre>
+                Next verify the signature with the following command:
+                <pre class="codeConfig">
+ssh people.apache.org
+cd ~/public_html/release/X.X.X
+gpg --verify ClickIDE-X.X.X-incubating.zip.asc ClickIDE-X.X.X-incubating.zip
+</pre>
+            </li>
+            <li>
+                Releases must be voted on before they are published. Please
+                see the <a href="releasing.html#voting">Voting</a>
+                section for details.
+            </li>
+            <li>
+                Incubating releases are published at <tt>people.apache.org</tt>
under
+                the folder:
+                <p/>
+                <tt>/www/www.apache.org/dist/incubator/click/<tt>SUBPROJECT</tt>/X.X.X</tt>
+
+                <p/>
+                <tt>SUBPROJECT</tt> should be replaced with the name of the subproject.
+                For example <tt>ClickIDE</tt> will be published to the folder:
+
+                <p/>
+                <tt>/www/www.apache.org/dist/incubator/click/clickide/X.X.X</tt>
+
+                <p/>
+                An easy way to do this is to copy the files in your <tt>public_html</tt>
+                folder for example:
+                <pre class="codeConfig">ssh people.apache.org
+cp ~/public_html/release/X.X.X/* /www/www.apache.org/dist/incubator/click/clickide/X.X.X
+</pre>
+            </li>
+             <li>
+                Email release announcement to <tt>click-user</tt> and <tt>click-dev</tt>
+                mailing lists.
+            </li>
+        </ol>
+
+        <p/>
+    </body>
+</html>

Modified: incubator/click/trunk/click/documentation/docs/developer-guide/releasing.html
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/documentation/docs/developer-guide/releasing.html?rev=731643&r1=731642&r2=731643&view=diff
==============================================================================
--- incubator/click/trunk/click/documentation/docs/developer-guide/releasing.html (original)
+++ incubator/click/trunk/click/documentation/docs/developer-guide/releasing.html Mon Jan
 5 10:26:22 2009
@@ -40,12 +40,12 @@
         <p/>
         <b>Please note</b> this section is for committers only.
 
-        <h3>Prerequisites</h3>
+        <h3><a href="#" name="prerequisites"></a>Prerequisites</h3>
 
         Before creating a release ensure you have setup your own public OpenGPG key signature
-        for signing and encrypting the distribution.
+        for signing the distribution.
         <p/>
-        A OpenGPG key can be generated using <a class="external" target="_blank" href="http://www.gnupg.org/">GnuPG</a>.
+        An OpenGPG key can be generated using <a class="external" target="_blank" href="http://www.gnupg.org/">GnuPG</a>.
         There is also a <a class="external" target="_blank" href="http://www.gpg4win.org/">Windows</a>
port available.
 
         <p/>
@@ -145,7 +145,7 @@
             </li>
         </ol>
 
-        <h3>Voting</h3>
+        <h3><a href="#" name="voting"></a>Voting</h3>
 
         Each release must be voted by the Incubator PMC on the <tt>click-dev</tt>
         mailing list and again on the <tt>general</tt> incubator list.



Mime
View raw message