incubator-odf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From devin...@apache.org
Subject svn commit: r1244876 - /incubator/odf/site/trunk/content/odftoolkit/odftoolkit-release-guide.mdtext
Date Thu, 16 Feb 2012 07:50:42 GMT
Author: devinhan
Date: Thu Feb 16 07:50:41 2012
New Revision: 1244876

URL: http://svn.apache.org/viewvc?rev=1244876&view=rev
Log:
CMS commit to odftoolkit by devinhan

Modified:
    incubator/odf/site/trunk/content/odftoolkit/odftoolkit-release-guide.mdtext

Modified: incubator/odf/site/trunk/content/odftoolkit/odftoolkit-release-guide.mdtext
URL: http://svn.apache.org/viewvc/incubator/odf/site/trunk/content/odftoolkit/odftoolkit-release-guide.mdtext?rev=1244876&r1=1244875&r2=1244876&view=diff
==============================================================================
--- incubator/odf/site/trunk/content/odftoolkit/odftoolkit-release-guide.mdtext (original)
+++ incubator/odf/site/trunk/content/odftoolkit/odftoolkit-release-guide.mdtext Thu Feb 16
07:50:41 2012
@@ -92,54 +92,61 @@ A release candidate is a set of artifact
   </modules>    
 
    Remove the comments of the following snippet in pom.xml to make sure Maven know how to
package:     
-    <code>   
-       &lt;!--&lt;profile>  
-           &lt;id>apache-release&lt;/id>   
-           &lt;properties>   
-              &lt;username>${user.name}&lt;/username>   
-           &lt;/properties>   
-           &lt;build>   
-              &lt;plugins>   
-                  ...   
-         &lt;/plugins>   
-      &lt;/build>   
-       &lt;/profile>-->   
-    </code>       
+   
+
+   &lt;!--&lt;profile>  
+       &lt;id>apache-release&lt;/id>   
+       &lt;properties>   
+          &lt;username>${user.name}&lt;/username>   
+       &lt;/properties>   
+       &lt;build>   
+          &lt;plugins>   
+              ...   
+     &lt;/plugins>   
+  &lt;/build>   
+   &lt;/profile>--> 
+
+  
+    
     Replace "${user.name}" with your Apache ID, such as "devinhan".       
     Use the following command to package.       
-    <code>    
-        mvn install -Papache-release       
-    </code>         
+   
+
+    mvn install -Papache-release  
+
+     
+       
     After package you should have the following files in the "target\":   
-    <code>          
-          $TAG-bin.tar.bz2    
-          $TAG-bin.tar.gz   
-          $TAG-bin.zip   
-          $TAG-src.tar.bz2    
-          $TAG-src.tar.gz    
-          $TAG-src.zip    
-          $TAG-doc.tar.bz2    
-          $TAG-doc.tar.gz   
-          $TAG-doc.zip   
-          *.asc   
-          *.md5   
-          *.sha   
-          vote.txt   
-    </code>   
+          
+      $TAG-bin.tar.bz2    
+      $TAG-bin.tar.gz   
+      $TAG-bin.zip   
+      $TAG-src.tar.bz2    
+      $TAG-src.tar.gz    
+      $TAG-src.zip    
+      $TAG-doc.tar.bz2    
+      $TAG-doc.tar.gz   
+      $TAG-doc.zip   
+      *.asc   
+      *.md5   
+      *.sha   
+      vote.txt 
+
+ 
     vote.txt is a draft of the dev vote mail. Each package has its own .asc, .md5 and .asc
files.    
       
  6. Upload artifacts for vote.      
     Login people.apache.org using your Apache LDAP account. Copy the artifacts packages to
directory "/public_html/odftoolkit-release/$TAG" using [scp][14]. If the directly don't exist,
please create. It is best to scp into the home directory and then copy into position from
there.         
     Make sure all of the files are owned by the incubator group, group readable and writable,
and read only for the world. In short -rw-rw-r--. To do this from the top level:         
     
-    <code>      
+           
           > find . -type f -exec chmod 664 {} \;     
           > find . -type d -exec chmod 775 {} \;  
           > chgrp -R incubator *          
-    </code>      
+       
     Then the artifacts can be accessed from Web browser. The link looks like:   
-    <code>    
+     
       http://people.apache.org/~$USER/odftoolkit-release/$TAG        
-    </code>        
+         
     Replace $USER with your Apache ID, such as "devinhan".        
 
 V. Incubator Release Vote     
@@ -149,75 +156,73 @@ After release candidate is uploaded, the
 1. Vote in ODF Toolkit Development List     
 A formal vote on candidate artifacts must be conducted by the release manager on the ODF
Toolkit development list. The vote mail can be drafted based on the vote.txt, which is generated
with artifacts. A sample looks like this:         
 
->    Subject: [VOTE] Release Apache ODF Toolkit 0.5-incubating(RC6)         
->         To: odf-dev@incubator.apache.org          
->         
->    Hi all,            
->    Please vote on releasing the following candidate as Apache ODF Toolkit (incubating)
version 0.5. This will be the first incubator     
->    release for ODF Toolkit in Apache.    
-> 
->    This release candidate fixes the following issues found in RC5:       
->    (1) Reomve JUnit declaration from NOTICE & LICENSE files.        
->    (2) Fix the "mvn clean" failed issue.         
-> 
->    The candidate for the ODF Toolkit 0.5-incubating release is available at:     
->    http://people.apache.org/~devinhan/odftoolkit-release/odftoolkit-0.5-incubating-rc6/
   
-> 
->    The release candidate is a zip archive of the sources in:         
->    https://svn.apache.org/repos/asf/incubator/odf/tags/odftoolkit-0.5-incubating/  
   
-> 
->    The SHA1 checksum of the archive is 44e16d8ee39fc0426f96aa7da9cd8eefccaf78e5.   

->    The MD5 checksum of the archive is c12a87f0ca441f23d945a423e1d4127c.       
-> 
->    Besides source code, binary packages and javadoc packages are also listed in:   
  
->    http://people.apache.org/~devinhan/odftoolkit-release/odftoolkit-0.5-incubating-rc6/
    
-> 
->    All of the artifacts supply three package formats, tar.gz, tar.bz2 and zip.     

-> 
->    Keys:         
->      http://www.apache.org/dist/incubator/odftoolkit/KEYS    
-> 
->    Please vote on releasing this package as Apache ODF Toolkit 0.5-incubating.     
  
->    The vote is open for the next full week, until next Saturday, Dec 31rd 6pm, because
of the Christmas holiday, and passes       
->    if a majority of at least 3 +1 IPMC votes are cast.      
->    [ ] +1 Release this package as Apache ODF Toolkit 0.5-incubating     
->    [ ] -1 Do not release this package because...      
->    
->    To learn more about Apache ODF Toolkit, please access: http://incubator.apache.org/odftoolkit/.
    
+       Subject: [VOTE] Release Apache ODF Toolkit 0.5-incubating(RC6)         
+            To: odf-dev@incubator.apache.org          
+       Hi all,                
+       Please vote on releasing the following candidate as Apache ODF Toolkit (incubating)
version 0.5. 
+       This will be the first incubator release for ODF Toolkit in Apache.    
+    
+       This release candidate fixes the following issues found in RC5:           
+       (1) Reomve JUnit declaration from NOTICE & LICENSE files.            
+       (2) Fix the "mvn clean" failed issue.         
+    
+       The candidate for the ODF Toolkit 0.5-incubating release is available at:        

+       http://people.apache.org/~devinhan/odftoolkit-release/odftoolkit-0.5-incubating-rc6/
   
+    
+       The release candidate is a zip archive of the sources in:             
+       https://svn.apache.org/repos/asf/incubator/odf/tags/odftoolkit-0.5-incubating/   
  
+    
+       The SHA1 checksum of the archive is 44e16d8ee39fc0426f96aa7da9cd8eefccaf78e5.    
   
+       The MD5 checksum of the archive is c12a87f0ca441f23d945a423e1d4127c.       
+    
+       Besides source code, binary packages and javadoc packages are also listed in:    
     
+       http://people.apache.org/~devinhan/odftoolkit-release/odftoolkit-0.5-incubating-rc6/
    
+    
+       All of the artifacts supply three package formats, tar.gz, tar.bz2 and zip.      
+    
+       Keys:         
+         http://www.apache.org/dist/incubator/odftoolkit/KEYS    
+    
+       Please vote on releasing this package as Apache ODF Toolkit 0.5-incubating.      
     
+       The vote is open for the next full week, until next Saturday, Dec 31rd 6pm, because
of the Christmas holiday, and passes
+       if a majority of at least 3 +1 IPMC votes are cast.          
+       [ ] +1 Release this package as Apache ODF Toolkit 0.5-incubating         
+       [ ] -1 Do not release this package because...      
+       To learn more about Apache ODF Toolkit, please access: http://incubator.apache.org/odftoolkit/.
    
 
 All votes are welcome, but only those votes by the project's PPMC members (or IPMC members)
count towards the final tally. The voting period should be no less than 72 hours, and at the
end of the voting the release manager should post a final tally to the list. eg.        
 
->    Subject: [RESULT][VOTE] Release Apache ODF Toolkit 0.5-incubating-rc7          
->        To: odf-dev@incubator.apache.org     
-> 
->    Hi All,        
->    The RC7 ballot has ended (due to New Year Holiday, we extended the vote to this Monday
) with the following results:    
-> 
->    From PPMC members:    
->    +1 daisyguo     
->    +1 devinhan   
->    +1 robweir       
->    +1 svanteschubert       
-> 
->    From Mentors:      
->    +1 yegor(IPMC)      
-> 
->    Other votes:     
->     (abstain non-binding [;<) orcmid    
-> 
->    I will send a vote mail to incubator-general mail list and collect another 2 IPMC
+1's votes.     
->    Thanks all of the voters.    
-
-The vote passes if there are at least 3 +1's from the PPMC/IPMC members and more +1's than
-1's. This is what is meant by majority consensus. If you've gotten this far, congratulations,
you're nearly ready to upload and announce the release.     
-If the vote is failed, the release manager should improve the artifacts based on the comments
and prepare new candidate. That means step "III. Release Candidate" need to rework. This process
maybe repeat several times until the vote passes.        
-**NOTE:** Please remember to delete old release candidates from Apache home space after new
candidates are uploaded.     
+      Subject: [RESULT][VOTE] Release Apache ODF Toolkit 0.5-incubating-rc7          
+          To: odf-dev@incubator.apache.org     
+       
+      Hi All,        
+      The RC7 ballot has ended (due to New Year Holiday, we extended the vote to this Monday
) with the following results:    
+       
+      From PPMC members:    
+      +1 daisyguo     
+      +1 devinhan   
+      +1 robweir       
+      +1 svanteschubert       
+       
+      From Mentors:      
+      +1 yegor(IPMC)      
+       
+      Other votes:     
+       (abstain non-binding [;<) orcmid    
+       
+      I will send a vote mail to incubator-general mail list and collect another 2 IPMC +1's
votes.     
+      Thanks all of the voters.    
+
+      The vote passes if there are at least 3 +1's from the PPMC/IPMC members and more +1's
than -1's. This is what is meant by majority consensus. If you've gotten this far, congratulations,
you're nearly ready to upload and announce the release.     
+      If the vote is failed, the release manager should improve the artifacts based on the
comments and prepare new candidate. That means step "III. Release Candidate" need to rework.
This process maybe repeat several times until the vote passes.        
+      **NOTE:** Please remember to delete old release candidates from Apache home space after
new candidates are uploaded.     
 
-2. Vote in General Incubator List       
+ 2. Vote in General Incubator List       
 In the case of the incubator, the IPMC must approve all releases. That means there is an
additional bit of voting that the release manager must now oversee on general@incubator in
order to gain that approval. The release manager must inform general@incubator that the vote
has passed on the project's development list, and should indicate any IPMC votes gained during
that process. A new vote on the release candidate artifacts must now be held on general@incubator
to seek majority consensus from the IPMC. Previous IPMC votes issued on the project's development
list count towards that goal. The sample mail is:      
 
-        Subject: [VOTE] Release Apache ODF Toolkit 0.5-incubating(RC7)        
-              To: general@incubator.apache.org     
-              Cc: odf-dev@incubator.apache.org       
+      Subject: [VOTE] Release Apache ODF Toolkit 0.5-incubating(RC7)        
+           To: general@incubator.apache.org     
+           Cc: odf-dev@incubator.apache.org       
           Hi all,      
 
           The ODF Toolkit 0.5 is ready for release.  This will be our first incubator release.
    
@@ -260,37 +265,37 @@ In the case of the incubator, the IPMC m
 
           To learn more about Apache ODF Toolkit, please access http://incubator.apache.org/odftoolkit/.
    
 
-Once the 72-hour minimum voting period has ended on general@incubator, the release manager
should tally the votes and declare a result. If majority consensus has been achieved with
respect to IPMC votes, the release manager may proceed with the release. Otherwise, the release
manager need to rework step(III) and step(IV) based on the received comments.      
-The vote result mail looks like:    
+   Once the 72-hour minimum voting period has ended on general@incubator, the release manager
should tally the votes and declare a result. If majority consensus has been achieved with
respect to IPMC votes, the release manager may proceed with the release. Otherwise, the release
manager need to rework step(III) and step(IV) based on the received comments.      
+   The vote result mail looks like:    
 
->         Subject: [VOTE] Release Apache ODF Toolkit 0.5-incubating(RC7)           
->              To: general@incubator.apache.org, odf-dev@incubator.apache.org        

->         Hi all,            
-> 
->         The Apache ODF Toolkit 0.5-incubating RC7 ballot has ended. We have received
4 IPMC +1 votes (plus an additional 4 PPMC +1 > votes)       
->         during the release voting on dev and general. The vote passed!       
-> 
->         Results:      
-> 
->         From IPMC members:       
->                  name                     apache id        
->               +1 Yegor Kozlov(mentor)       yegor        
->               +1 Nick Burch(mentor)         nick          
->               +1 Chris Mattmann             mattmann       
->               +1 Christian Grobmeier        grobmeier        
->               
->         From PPMC members:        
->                  name                      apache id      
->               +1  Ying Chung Guo              daisyguo        
->               +1  Biao Han                    devinhan      
->               +1  Rob Weir                    robweir        
->               +1  Svante Schubert             svanteschubert      
-> 
->         Other votes:      
->                                           name                       apache id     

->               (abstain non-binding [;<)   Dennis E. Hamilton        orcmid      
  
-> 
->          We will work on releasing ODF Toolkit 0.5. Thank you everyone who worked in
this release!      
+          Subject: [VOTE] Release Apache ODF Toolkit 0.5-incubating(RC7)           
+               To: general@incubator.apache.org, odf-dev@incubator.apache.org         
+          Hi all,            
+  
+          The Apache ODF Toolkit 0.5-incubating RC7 ballot has ended. We have received 4
IPMC +1 votes (plus an additional 4 PPMC +1   votes)       
+          during the release voting on dev and general. The vote passed!       
+  
+          Results:      
+  
+          From IPMC members:       
+                   name                     apache id        
+                +1 Yegor Kozlov(mentor)       yegor        
+                +1 Nick Burch(mentor)         nick          
+                +1 Chris Mattmann             mattmann       
+                +1 Christian Grobmeier        grobmeier        
+                
+          From PPMC members:        
+                   name                      apache id      
+                +1  Ying Chung Guo              daisyguo        
+                +1  Biao Han                    devinhan      
+                +1  Rob Weir                    robweir        
+                +1  Svante Schubert             svanteschubert      
+  
+          Other votes:      
+                                            name                       apache id      
+                (abstain non-binding [;<)   Dennis E. Hamilton        orcmid         
+  
+           We will work on releasing ODF Toolkit 0.5. Thank you everyone who worked in this
release!      
 
 VI. After the Vote   
 ------------------------------    
@@ -299,15 +304,15 @@ VI. After the Vote   
    The directory of ODF Toolkit is http://www.apache.org/dist/incubator/odftoolkit/. The
release manager should move the release artifacts from /public_html/odftoolkit-release/$TAG
to this directory.            
 
 2. Mirroring       
-   To avoid excessive use of bandwidth and to increase download speeds, official releases
are made available through a global network of volunteer mirrors. Using these mirrors has
some notable differences from unmirrored downloads. In particular, a <a href="http://www.apache.org/dev/release-download-pages.html">script</a>
must be used to direct the download to an appropriate URL. The mdtext format sample is:  
        
-   {code}       
->    **Current Version (0.5-incubating)**            
->    * Source:     
->    * [odftoolkit-0.5-incubating-src.tar.gz](http://www.apache.org/dyn/closer.cgi/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz)
   
->      [[asc](http://www.apache.org/dist/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz.asc)]
  
->      [[md5](http://www.apache.org/dist/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz.md5)]
  
->      [[sha](http://www.apache.org/dist/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz.sha)]
   
-   {code}    
+   To avoid excessive use of bandwidth and to increase download speeds, official releases
are made available through a global network of volunteer mirrors. Using these mirrors has
some notable differences from unmirrored downloads. In particular, a <a href="http://www.apache.org/dev/release-download-pages.html"
script</a  must be used to direct the download to an appropriate URL. The mdtext format
sample is:           
+       
+     \*\*Current Version (0.5-incubating)**            
+     \* Source:     
+     \* \[odftoolkit-0.5-incubating-src.tar.gz\](http://www.apache.org/dyn/closer.cgi/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz)
   
+       \[\[asc\](http://www.apache.org/dist/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz.asc)\]
  
+       \[\[md5\](http://www.apache.org/dist/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz.md5)\]
  
+       \[\[sha\](http://www.apache.org/dist/incubator/odftoolkit/sources/odftoolkit-0.5-incubating-src.tar.gz.sha)\]
   
+        
    Users will download the mirrored release artifacts from machines outside Apache control.
Users need to verify that the copy downloaded is identical to the original. Mirrored copies
of checksums, KEYS and signature files (.asc and .md5 files) will be present on the mirrors
but must never be used for verification. So, all links from the podling website to signatures,
sums and KEYS need to refer to the original documents on www.apache.org. See release signing
guide for more information.                
      
 3. Archiving              
@@ -323,7 +328,7 @@ VI. After the Vote   
      
 6. Send Announcements       
    The release manager need to send announcements to odf-user and odf-dev lists. Note, announcements
should be sent from your @apache.org e-mail address. The sample looks like:      
-   {code}     
+         
    Subject:[ANNOUNCEMENT] Apache ODF Toolkit(Incubating) 0.5-incubating Release     
    To: odf-users@incubator.apache.org      
    Hi all,       
@@ -339,7 +344,7 @@ VI. After the Vote   
    \[1] http://www.apache.org/dist/incubator/odftoolkit/CHANGES-0.5-incubating.txt.    
    \[2] http://incubator.apache.org/odftoolkit/mailing-lists.html.    
    \[3] http://incubator.apache.org/odftoolkit/downloads.html               
-  {code}
+   
 
 References        
 -------------------------  



Mime
View raw message