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 2013/09/03 16:42:15 UTC

[Cordova Wiki] Update of "StepsForToolsRelease" by AndrewGrieve

Dear Wiki user,

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

The "StepsForToolsRelease" page has been changed by AndrewGrieve:
https://wiki.apache.org/cordova/StepsForToolsRelease

New page:
'''''THIS PAGE IS CURRENTLY UNDER REVIEW'''''

= Release Process for ''Plugman and CLI'' =

Plugman and CLI are released at most weekly (see: VersioningAndReleaseStrategy).

A tools release is performed by a single person each week. We call this person the "Release Master". How to select the Release Master is still TDB. 

== Get Buy-in ==

 1. Email the dev mailing-list and see if anyone has reason to postpone the release.
   * If so, agree upon a branching date / time.

== Create JIRA issues ==

 * Create a JIRA issue to track the status of the release.
   * Comments should be added to this bug after each top-level step below is taken

== Update Changelog & Version ==
 a. Update each repo's CHANGELOG.md file with changes
 a. Increase the version within package.json using `SemVer`, and remove the ''-dev'' suffix
 a. For CLI, update the version of plugman that it depends on
 a. Commit these two changes together into one commit

{{{
  ./cordova-coho/coho repo-update -r cli -r plugman
  git log --no-merges --format="%h %s" prev..master
  # Copy & paste into CHANGELOG.md
  # Edit version within package.json based off of changes.
  git commit -am "[CB-####] Updated version and changelog for release ''$VERSION''"
}}}

== Test ==
 * Ensure that cordova-mobile-spec/createmobilespec.sh works.
 * Run `npm test`

== Prepare Blog Post ==
 * Combine highlights from changelogs into a Release Announcement blog post
   * Instructions on [[https://svn.apache.org/repos/asf/cordova/site/README.md|sites page README]]
 * Get blog post proofread.

== Publish to NPM ==
For plugman, and then for CLI:
{{{
  cd cordova-plugman
  git tag --force prev
  git tag $VERSION
  npm publish .
}}}

== Post Blog Post ==
{{{
  svn commit
}}}

== Update version to `dev` ==
 * For each repo:
{{{
  # Edit version within package.json by incrementing the micro and adding the ''-dev'' suffix.
  git commit -am "[CB-####] Added `dev` suffix to version."
}}}

== Close JIRA Issue ==
 * Double check that the issue has comments that record the steps you took
 * Mark it as fixed

== Finally: ==

 * Update *these wiki instructions* if they were missing anything.