You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by Apache Wiki <wi...@apache.org> on 2012/09/14 02:39:28 UTC

[Cordova Wiki] Update of "CuttingReleases" by Steven Gill

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Cordova Wiki" for change notification.

The "CuttingReleases" page has been changed by Steven Gill:
http://wiki.apache.org/cordova/CuttingReleases?action=diff&rev1=11&rev2=12

  = Apache Cordova Releases =
  
- An official source release contains code for each Apache Cordova platform, the documentation and various other artifacts. 
+ An official source release contains the source code for the repositories of the Apache Cordova platform, the signing keys and various checks to prove the validity of the release. 
  
  {{{
  
   /
-  |- bin/ ........ the cordova binaries for building apps!
-  |- doc/ ........ compiled cordova-docs
-  |- KEYS ........ signing keys
-  |- src/ ........ export all platform src dirs
+  |- KEYS .................................. signing keys
+  |- cordova-VERSION-incubating-src.zip .... zip file that contains the src of all platform repos
+  |- .md5 .................................. md5 file containing the MD5 Checksum of the src zip
+  |- .sha .................................. sha file containing the SHA Hash of the src zip
+  |- .asc .................................. asc file that contains the ASCII Armoring of the zip
+ 
  
  
  }}}
  
- The {{{/src/}}} is the official release artifact and contains the source code for all the platforms, the top level documents concerning licences, notices, disclaimer, and as well the readme for the Apache Cordova project. 
+ The {{{/cordova-VERSION-incubating-src.zip/}}} is the official release artifact and contains the source code for all the platforms, the top level documents concerning licences, notices, disclaimer, and as well the readme for the Apache Cordova project. 
  
  {{{
  
  /
+ |-changelog
  |-DISCLAIMER
- |-incubator-cordova-android/
+ |-incubator-cordova-android.zip
+ |-incubator-cordova-app-hello-world.zip
- |-incubator-cordova-bada/
+ |-incubator-cordova-bada.zip
+ |-incubator-cordova-bada-wac.zip
- |-incubator-cordova-blackberry-webworks/
+ |-incubator-cordova-blackberry-webworks.zip
+ |-incubator-cordova-docs.zip
+ |-incubator-cordova-js.zip
- |-incubator-cordova-ios/
+ |-incubator-cordova-ios.zip
+ |-incubator-cordova-mac.zip
+ |-incubator-cordova-mobile-spec.zip
+ |-incubator-cordova-qt.zip
+ |-incubator-cordova-tizen.zip
- |-incubator-cordova-webos
+ |-incubator-cordova-webos.zip
- |-incubator-cordova-wp7/
+ |-incubator-cordova-wp7.zip
  |-LICENSE
  |-NOTICE
  |-README.MD
  
- }}}
- 
- The {{{/bin/}}} is what you want if you want to start building apps with Cordova.
- 
- {{{
- 
- /
- |-android/
- |-bada/
- |-blackberry/
- |-ios/
- |-symbian/
- |-webos/
- |-windows/
  
  }}}
  
- The {{{/doc/}}} is where the main documentation resides for the Apache Cordova project. To note: a release will only contain the documentation for that version of the release. If a user launches the index.html and tries to change to a different version, it will currently 404 out.  
+ == Steps to Cut a Apache Cordova Release ==
+ 
+  1. Prepare the release candidate using coho. Put online for others to access and download.
+  2. Start a VOTE thread on the Cordova mailing list. See http://markmail.org/message/fzmlzbvt3dgdpfrc and http://mail-archives.apache.org/mod_mbox/stdcxx-dev/200601.mbox/%3c43C1C0A0.7040401@roguewave.com%3e for good examples.
+  3. People review the release candidate and cast their votes accordingly. See http://www.apache.org/dev/release.html#approving-a-release and http://www.apache.org/dev/release.html#what-must-every-release-contain for things to consider.
+  4. A majority of at least three +1 votes from the (P)PMC is needed for the vote to pass.
+  5. In a normal TLP this would be sufficient, but in the Incubator an extra vote round is needed, see http://incubator.apache.org/incubation/Incubation_Policy.html#Releases.
+  6. To do this, start a vote on general@incubator.apache.org. See http://markmail.org/message/jelahpbnimn26fcu for a good recent example. This needs to happen after the first vote is successfully completed.
+  7. A majority of at least three +1 votes from the IPMC are needed for the vote to pass.
+  8. Make the approved release available at http://www.apache.org/dist/incubator/cordova/ and update the project website to point to the new release
+  9. Announce the release to the world!
+ 
  
  == Release Philosophy ==