jspwiki-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From juanpa...@apache.org
Subject svn commit: r1332980 - in /incubator/jspwiki/site/trunk: content/jspwiki/ppmc/how_to_release.mdtext templates/skeleton.html
Date Wed, 02 May 2012 10:27:26 GMT
Author: juanpablo
Date: Wed May  2 10:27:25 2012
New Revision: 1332980

URL: http://svn.apache.org/viewvc?rev=1332980&view=rev
Log:
JSPWIKI-727: Improve project's incubator website 

- content for how_to_release.mdtext, mostly taken from MRUnit site.
- removed remaining spanish text in the skeleton file.

Modified:
    incubator/jspwiki/site/trunk/content/jspwiki/ppmc/how_to_release.mdtext
    incubator/jspwiki/site/trunk/templates/skeleton.html

Modified: incubator/jspwiki/site/trunk/content/jspwiki/ppmc/how_to_release.mdtext
URL: http://svn.apache.org/viewvc/incubator/jspwiki/site/trunk/content/jspwiki/ppmc/how_to_release.mdtext?rev=1332980&r1=1332979&r2=1332980&view=diff
==============================================================================
--- incubator/jspwiki/site/trunk/content/jspwiki/ppmc/how_to_release.mdtext (original)
+++ incubator/jspwiki/site/trunk/content/jspwiki/ppmc/how_to_release.mdtext Wed May  2 10:27:25
2012
@@ -1,3 +1,245 @@
-Title: How to release
+Title: How to Release
 
-<span class="warning">TBD</span>
\ No newline at end of file
+## How to Release
+
+[TOC]
+
+<div style="clear:both;">
+(most of the content grabbed/adapted from MRUnit site)
+</div>  
+
+  
+## First time release managers
+
+  1. Generate [PGP code signing keys][]
+  2. Add the PGP code signing keys to the [KEYS file][] as documented on the 
+[Infrastructure site][]
+  3. Put in a [Infrastructure JIRA][] asking to get added to the incubator unix 
+group on people.apache.org <!--and the jspwiki deployer role for Nexus-->
+  4. Copy the modified KEYS file to the release folder 
+/www/www.apache.org/dist/incubator/jspwiki on people.apache.org and ensure it 
+has 0664 permissions.
+
+<!---
+  5. Add the following to your Maven settings.xml file:
+
+        <servers>
+          <server>
+            <id>apache.releases.https</id>
+            <username>APACHE-ID</username>
+            <password>APACHE-PASSWORD</password>
+          </server>
+        </servers>
+-->
+It is convenient to [setup the ssh keys][] on people.apache.org, otherwise 
+you'll have to enter your login password a number of times.
+
+## Create a release candidate
+
+  1. Generate release notes
+
+    1. Update CHANGES.txt with [new release notes from JIRA][], select the 
+version and set the style to Text
+    2. Commit the updated CHANGES.txt with message: "Preparing for release 
+X.Y.Z-incubating"
+  
+<!---
+  2. Create a branch (only required for the first release in a series (X.Y.0))
+
+    1. Create a branch for the X.Y release series
+
+            svn copy https://svn.apache.org/repos/asf/incubator/jspwiki/trunk \
+            https://svn.apache.org/repos/asf/incubator/jspwiki/branches/jspwiki-X.Y -m "Branching
for X.Y releases"
+
+    2. Bump the version number in trunk and commit (the update-versions script 
+mangles the whitespace in the root XML element):
+
+            sed -i "" -e "s/X.Y.0-incubating-SNAPSHOT/X.Y+1.0-incubating-SNAPSHOT/" pom.xml
+
+    3. Checkout the release branch:
+
+            svn checkout https://svn.apache.org/repos/asf/incubator/jspwiki/branches/jspwiki-X.Y
+
+  3. Remove -SNAPSHOT from the release branch and commit
+
+        sed -i "" -e "s/X.Y.Z-incubating-SNAPSHOT/X.Y.Z-incubating/" pom.xml
+
+  4. Deploy to Nexus Staging Repository
+
+    1. Deploy artifact:
+
+            mvn clean deploy -Psign
+
+    2. Verify licenses in target/rat.txt
+
+    3. Login to <https://repository.apache.org> and select Staging Repositories 
+on the left under Build Promotion.
+    4. Select org.apache.jspwiki from the list of repositories, select the 
+current repository and delete any asc.md5/asc.sha1 files. Then click Close 
+using "Apache JSPWiki X.Y.Z-incubating" as the description to allow others 
+to see the repository.
+-->
+  2. Deploy source and binary distributions
+
+    1. Generate the src & bin distributions:
+
+            ant clean signeddist
+
+    2. Copy the src distribution file and checksums to people.apache.org,
+excluding the asc.md5/asc.sha1 files:
+
+            scp target/*.tar.gz* username@people.apache.org:~/public_html/jspwiki-X.Y.Z-incubating-candidate-$RC
+
+<!---
+    3. Generate the bin distribution:
+
+            mvn clean assembly:single gpg:sign checksum:artifacts -Pdist-bin
+
+    4. Copy the bin distribution file and checksums to people.apache.org,
+excluding the asc.md5/asc.sha1 files:
+
+            rm target/*asc.*
+            scp target/*.tar.gz* username@people.apache.org:~/public_html/jspwiki-X.Y.Z-incubating-candidate-$RC
+-->
+  3. Tag the release candidate:
+
+        svn copy https://svn.apache.org/repos/asf/incubator/jspwiki/branches/jspwiki-X.Y/
\
+        https://svn.apache.org/repos/asf/incubator/jspwiki/tags/release-X.Y.Z-incubating/
-m "jspwiki X.Y.Z-incubating release."
+
+## Run a vote
+
+Send the following to jspwiki-dev@incubator.apache.org and 
+general@incubator.apache.org:
+
+<!---
+    Subject: [VOTE] Release JSPWiki version X.Y.Z-incubating
+    
+    This is an incubator release for Apache JSPWiki, version X.Y.Z-incubating.
+    
+    It fixes the following issues:
+    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310732&version=<REPLACE>
+    
+    *** Please download, test and vote by [3 working days after sending].
+    
+    Note that we are voting upon the source (tag), binaries are provided for convenience.
+    
+    Source and binary files:
+    http://people.apache.org/~<REPLACE>/jspwiki-X.Y.Z-incubating-candidate-$RC
+
+    Maven staging repo:
+    https://repository.apache.org/content/repositories/orgapachejspwiki-<REPLACE>/
+
+    The tag to be voted upon:
+    http://svn.apache.org/repos/asf/incubator/jspwiki/tags/release-X.Y.Z-incubating/
+    
+    JSPWiki's KEYS file containing PGP keys we use to sign the release:
+    http://svn.apache.org/repos/asf/incubator/jspwiki/trunk/KEYS
+-->
+
+    Subject: [VOTE] Release JSPWiki version X.Y.Z-incubating
+    
+    This is an incubator release for Apache JSPWiki, version X.Y.Z-incubating.
+    
+    It fixes the following issues:
+    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310732&version=<REPLACE>
+    
+    *** Please download, test and vote by [3 working days after sending].
+    
+    Note that we are voting upon the source (tag), binaries are provided for convenience.
+    
+    Source and binary files:
+    http://people.apache.org/~<REPLACE>/jspwiki-X.Y.Z-incubating-candidate-$RC
+
+    The tag to be voted upon:
+    http://svn.apache.org/repos/asf/incubator/jspwiki/tags/release-X.Y.Z-incubating/
+    
+    JSPWiki's KEYS file containing PGP keys we use to sign the release:
+    http://svn.apache.org/repos/asf/incubator/jspwiki/trunk/KEYS
+    
+Note that the Incubator PMC needs to vote upon the release after a successful 
+PPMC vote before any release can be made official.
+
+## Roll Out
+
+If the vote passes, roll out the release:
+
+<!---
+  1. Publish Nexus repository:
+    1. Login to <https://repository.apache.org> and select Staging Repositories 
+on the left under Build Promotion.
+    2. Select the repository that was closed earlier, and click Release, using 
+the description "Apache jspwiki X.Y.Z-incubating artifacts"
+-->
+  1. Publish src and bin distributions to the [mirrors][]:
+
+        ssh people.apache.org
+        VERSION=X.Y.Z
+        PREVIOUS_VERSION=X.Y.Z
+        CANDIDATE=C
+        cp -r ~/public_html/jspwiki-$VERSION-incubating-candidate-$CANDIDATE \
+        /www/www.apache.org/dist/incubator/jspwiki/jspwiki-$VERSION-incubating
+        cd /www/www.apache.org/dist/incubator/jspwiki
+        chgrp -R incubator jspwiki-$VERSION-incubating
+        chmod -R g+w jspwiki-$VERSION-incubating
+        rm -r /www/www.apache.org/dist/incubator/jspwiki/jspwiki-$PREVIOUS_VERSION-incubating
# remove older versions
+
+    The last line is to remove the previous version, since only the most recent 
+version on a particular branch should be in the dist directory. Older versions 
+are [archived][] automatically.
+
+  2. Wait 24 hours for mirrors to sync
+  3. Post the javadoc to the site:
+
+    1. Create the javadoc:
+
+            ant javadoc
+
+    2. Copy javadocs to https://svn.apache.org/repos/infra/websites/production/jspwiki/documentation/javadocs/X.Y.Z-incubating
+    3. Add a link to index.html of the javadoc in the documentation/javadoc.mdtext page
+
+  4. Post link to the full release notes along with links to the major JIRA 
+changes on the front page of the site
+
+## Announce the release
+
+Send the following from an apache.org address to announce@apache.org, 
+jspwiki-user@incubator.apache.org, jspwiki-dev@incubator.apache.org:
+
+    Subject: [ANNOUNCE] Apache JSPWiki X.Y.Z-incubating released
+    
+    The Apache JSPWiki team is pleased to announce the release of JSPWiki
+    X.Y.Z-incubating from the Apache Incubator.
+    
+    This is the <REPLACE> release of Apache JSPWiki, a feature-rich and 
+    extensible WikiWiki engine built around the standard J2EE components.
+    
+    The release is available here:
+    http://www.apache.org/dyn/closer.cgi/incubator/jspwiki/
+    
+    The full change log is available here:
+    https://issues.apache.org/jira/browse/jspwiki/fixforversion/<REPLACE>
+    
+    We welcome your help and feedback. For more information on how to
+    report problems, and to get involved, visit the project website at
+    http://incubator.apache.org/jspwiki/
+    
+    The Apache JSPWiki Team
+
+## Add the next release to JIRA
+
+  1. Add the [next version number to JIRA][]
+  2. Mark the released version as "released" with a release date
+
+
+[PGP code signing keys]: http://www.apache.org/dev/release-signing.html#generate
+[KEYS file]: http://svn.apache.org/repos/asf/incubator/jspwiki/dist/KEYS
+[Infrastructure site]: http://www.apache.org/dev/release-signing.html#keys-policy
+[Infrastructure JIRA]: https://issues.apache.org/jira/browse/INFRA
+[setup the ssh keys]: http://www.thegeekstuff.com/2008/11/3-steps-to-perform-ssh-login-without-password-using-ssh-keygen-ssh-copy-id/
+
+[new release notes from JIRA]: https://issues.apache.org/jira/secure/ConfigureReleaseNote.jspa?projectId=12311292
+
+[archived]: http://archive.apache.org/dist/incubator/jspwiki/
+[mirrors]: http://www.apache.org/dev/mirrors.html
+
+[next version number to JIRA]: https://issues.apache.org/jira/plugins/servlet/project-config/jspwiki/versions

Modified: incubator/jspwiki/site/trunk/templates/skeleton.html
URL: http://svn.apache.org/viewvc/incubator/jspwiki/site/trunk/templates/skeleton.html?rev=1332980&r1=1332979&r2=1332980&view=diff
==============================================================================
--- incubator/jspwiki/site/trunk/templates/skeleton.html (original)
+++ incubator/jspwiki/site/trunk/templates/skeleton.html Wed May  2 10:27:25 2012
@@ -76,7 +76,7 @@
         <a class="activetab" id="menu-pagecontent" accesskey="J" href="/jspwiki/index.html">
           <span class="accesskey">J</span>SPWiki&nbsp;
         </a>
-        <!-- <a id="menu-attach" accesskey="a"><span class="accesskey">A</span>djuntar</a>
+        <!-- <a id="menu-attach" accesskey="a"><span class="accesskey">A</span>ttach</a>
         <a id="menu-info" href="http://www.jspwiki.org/PageInfo.jsp?page=Main" accesskey="i"><span
class="accesskey">I</span>nfo</a> -->
       </div>
       



Mime
View raw message