Dear Wiki user,

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

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

New page:
= Release Process for ''Core Plugins'' =

Core Plugins are released at most weekly (see: VersioningAndReleaseStrategy).

A plugins release is performed by a single person each week. We call this 
person the "Plugins Release Master" :). How to select the Plugins 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

== Identify which plugins have changes ==

{{{
  ./cordova-coho/coho repo-update -r plugins
  ./cordova-coho/coho foreach -r plugins "git log --oneline master..dev"
}}}

 * Add a comment to the JIRA issue stating which plugins had commits

== Update Changelog & Version ==
 * For each plugin that has unreleased commits:
   a. Update its CHANGELOG.md file with changes
   b. Increase the plugin's version within plugin.xml using `SemVer`, and 
remove the ''-dev'' suffix.
   c. Commit these two changes together to the `dev` branch

{{{
  git log --no-merges --format="%h %s" dev..master
  # Copy & paste into CHANGELOG.md
  # Edit version within plugin.xml based off of changes.
  git commit -am "Updated version and changelog for release ''$VERSION''"
}}}


== Merge Changes into master ==
{{{
  ./cordova-coho/coho foreach -r plugins "git checkout master"
  ./cordova-coho/coho foreach -r plugins "git merge dev --ff-only"
}}}

== Update dev branch's version ==
 * For each plugin that had unreleased commits:
{{{
  git checkout dev
  # Edit version within plugin.xml by incrementing the micro and adding the 
''-dev'' suffix.
  git commit -am "Incremented plugin version on dev branch."
}}}

== Test ==
 * Create mobilespec using the old versions of plugins
 * Perform a "plugin upgrade" for plugins that have changes
   * Right now, this means doing a `plugin remove` followed by a `plugin add`
 * Run through mobilespec, ensuring to do manual tests that relate to changes 
in the changelog

== Prepare Blob 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 proof-read.

== Push! ==
{{{
  # Blog Post:
  svn commit
  # Plugin Changes:
  ./cordova-coho/coho repo-push -r plugins -b dev -b master
}}}

== 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.

Reply via email to