You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ia...@apache.org on 2014/04/25 20:51:01 UTC
git commit: Update plugins release doc
Repository: cordova-coho
Updated Branches:
refs/heads/master 03097d5f7 -> 27c706601
Update plugins release doc
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/27c70660
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/27c70660
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/27c70660
Branch: refs/heads/master
Commit: 27c706601356221e88d46977ea3bbaaa20bd69c8
Parents: 03097d5
Author: Ian Clelland <ic...@chromium.org>
Authored: Fri Apr 25 14:47:05 2014 -0400
Committer: Ian Clelland <ic...@chromium.org>
Committed: Fri Apr 25 14:50:12 2014 -0400
----------------------------------------------------------------------
docs/plugins-release-process.md | 38 ++++++++++++++++++++++++++----------
1 file changed, 28 insertions(+), 10 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/27c70660/docs/plugins-release-process.md
----------------------------------------------------------------------
diff --git a/docs/plugins-release-process.md b/docs/plugins-release-process.md
index 036a478..bd8d4f6 100644
--- a/docs/plugins-release-process.md
+++ b/docs/plugins-release-process.md
@@ -23,16 +23,18 @@ TODO: Should not mention testing other than checking medic
## Get Buy-in
1. Email the dev mailing-list and see if anyone has reason to postpone the release.
+ * Subject should be "[DISCUSS] Plugins release
* If so, agree upon a branching date / time.
## Create JIRA issues
* Create a JIRA issue to track the status of the release.
* Make it of type "Task"
- * Title should be "Plugins Release _Feb 2, 2014_"
+ * Subject should be "Plugins Release _Feb 2, 2014_" (Use the current date, not the expected release date)
* Description should be: "Following steps at https://github.com/apache/cordova-coho/blob/master/docs/plugins-release-process.md"
+ * Assignee should be the Release Manager
* Comments should be added to this bug after each top-level step below is taken
- * Set a variable for use later on:
+ * Set an environment variable in your terminal for use later on:
JIRA="CB-????" # Set this to the release bug.
@@ -46,10 +48,11 @@ TODO: Should not mention testing other than checking medic
coho foreach -r plugins "git checkout dev"
# Merge any commits mistakenly made to master into dev:
- (for l in cordova-plugin-*; do ( cd $l; git merge master ); done
+ (for l in cordova-plugin-*; do ( echo $l; cd $l; git merge master ); done
# Sanity check and push if needed:
coho repo-status -r plugins -b dev
+ coho foreach -r plugins "git status -s"
coho repo-push -r plugins -b dev
## Identify which plugins have changes
@@ -65,7 +68,7 @@ TODO: Should not mention testing other than checking medic
## Update RELEASENOTES.md & Version
Remove the ''-dev'' suffix on the version in plugin.xml.
- for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; if [ $v = *-dev ); then v2="${v%-dev}"; echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; v2="${v%-dev}"; if [ $v != $v2 ]; then echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
If the changes merit it, manually bump the major / minor version instead of the micro. Manual process, but list the changes via:
@@ -79,6 +82,10 @@ Update its RELEASENOTES.md file with changes
# Then curate:
vim ${ACTIVE// //RELEASENOTES.md }/RELEASENOTES.md
+Print all changes for plugins (save this text for the blog post):
+
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; id=$(grep -o '\bid=\"[^\"]*\"' plugin.xml | head -n1 | cut -d'"' -f2); echo -e "\n\`$id@$v\`"; git log --pretty=format:'* %s' --topo-order --no-merges master..dev | grep -v "Incremented plugin version"); done
+
Add a comment to the JIRA issue with the output from:
for l in $ACTIVE; do ( cd $l; id="$(grep id= plugin.xml | grep -v xml | grep -v engine | grep -v param | head -1 | cut -d'"' -f2)"; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; echo $id@$v; awk "{ if (p) print } /$DATE/ { p = 1 } " < RELEASENOTES.md; echo); done
@@ -91,18 +98,19 @@ Commit these two changes together to the `dev` branch
for l in $ACTIVE; do ( cd $l; v="r$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; echo "Tagging $l to $v"; git tag "$v" ); done
-## Update dev branch's version
-
- for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; if [ $v != *-dev ); then v2="$(echo $v|awk -F"." '{$NF+=1}{print $0RT}' OFS="." ORS="")-dev"; echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
- for l in $ACTIVE; do (cd $l; git commit -am "$JIRA Incremented plugin version on dev branch." ); done
-
## Test
* Create mobilespec using the old versions of plugins (by checking them out to the previous tag)
* Run through mobilespec, ensuring to do manual tests that relate to changes in the RELEASENOTES.md
+## Update dev branch's version
+
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; v_no_dev="${v%-dev}"; if [ $v = $v_no_dev ]; then v2="$(echo $v|awk -F"." '{$NF+=1}{print $0RT}' OFS="." ORS="")-dev"; echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
+ for l in $ACTIVE; do (cd $l; git commit -am "$JIRA Incremented plugin version on dev branch." ); done
+
## Push Dev Branch
# Sanity check:
coho repo-status -r plugins -b dev
+ coho foreach -r plugins "git status -s"
# Push:
for l in $ACTIVE; do ( cd $l; git push --tags https://git-wip-us.apache.org/repos/asf/$l.git dev); done
@@ -137,7 +145,7 @@ Send an email to dev ML with:
__Subject:__
- [Vote] Plugins Release
+ [VOTE] Plugins Release
__Body:__
@@ -161,6 +169,12 @@ __Body:__
## Email the result of the vote
Respond to the vote thread with:
+__Subject:__
+
+ [RESULT][VOTE] Plugins Release
+
+__Body:__
+
The vote has now closed. The results are:
Positive Binding Votes: (# of PMC members that +1'ed)
@@ -171,6 +185,10 @@ Respond to the vote thread with:
.. names of all -1 PMC members ..
+ Other Votes:
+
+ .. list any non-binding votes, from non-PMC members ..
+
The vote has passed.
_Note: list of PMC members: http://people.apache.org/committers-by-project.html#cordova-pmc_