You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2017/05/10 22:28:42 UTC
[1/4] cordova-coho git commit: Changed version to 1.0.0-dev
Repository: cordova-coho
Updated Branches:
refs/heads/master bf60fdfc1 -> b6fb6b0cd
Changed version to 1.0.0-dev
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/90ae3acd
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/90ae3acd
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/90ae3acd
Branch: refs/heads/master
Commit: 90ae3acd74315d12c8e33fabf59d3f0a11ea04a2
Parents: bf60fdf
Author: Shazron Abdullah <sh...@gmail.com>
Authored: Wed May 10 15:27:50 2017 -0700
Committer: Shazron Abdullah <sh...@gmail.com>
Committed: Wed May 10 15:27:50 2017 -0700
----------------------------------------------------------------------
package.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/90ae3acd/package.json
----------------------------------------------------------------------
diff --git a/package.json b/package.json
index 97e34d8..af1c1bd 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "cordova-coho",
- "version": "0.0.3",
+ "version": "1.0.0-dev",
"description": "Apache Cordova release tool",
"main": "./coho",
"bin": {
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org
[2/4] cordova-coho git commit: Added coho-release-process doc
Posted by sh...@apache.org.
Added coho-release-process 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/bf5470d5
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/bf5470d5
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/bf5470d5
Branch: refs/heads/master
Commit: bf5470d5d4bdd0a0367a3656981d47bb26610aa1
Parents: 90ae3ac
Author: Shazron Abdullah <sh...@gmail.com>
Authored: Wed May 10 15:28:03 2017 -0700
Committer: Shazron Abdullah <sh...@gmail.com>
Committed: Wed May 10 15:28:03 2017 -0700
----------------------------------------------------------------------
docs/coho-release-process.md | 287 ++++++++++++++++++++++++++++++++++++++
1 file changed, 287 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/bf5470d5/docs/coho-release-process.md
----------------------------------------------------------------------
diff --git a/docs/coho-release-process.md b/docs/coho-release-process.md
new file mode 100644
index 0000000..dc5c163
--- /dev/null
+++ b/docs/coho-release-process.md
@@ -0,0 +1,287 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+
+# Release Process for 'coho'
+
+Before cutting any releases, read the Apache's [Releases Policy](http://www.apache.org/dev/release)
+
+If you have not done so already, create a GPG key (see: [setting-up-gpg.md](setting-up-gpg.md)).
+
+## Decide on the next version numbers
+According [versioning-and-release-strategy.md](versioning-and-release-strategy.md) patch version bumps (the last of 3 numbers) should only be used for fixes and updates of references to platform versions. For any change in functionality, the second (minor) part of the version should be bumped and new branch created. Instructions for creating a new release branch are further down on this page.
+
+## Get Buy-in
+
+Email the dev mailing-list and see if anyone has reason to postpone the release.
+
+E.g.:
+
+ Subject: [DISCUSS] Coho Release
+
+ Does anyone have any reason to delay a Coho release?
+ Any outstanding patches to land?
+
+ If not, I will start the release tomorrow.
+
+
+## Create JIRA issues
+
+ * Create a JIRA issue to track the status of the release.
+ * Make it of type "Task"
+ * Title should be "Coho Release _May 10, 2017_"
+ * Description should be: "Following steps at https://github.com/apache/cordova-coho/blob/master/docs/coho-release-process.md"
+ * Comments should be added to this bug after each top-level step below is taken
+ * Set a variable for use later on:
+
+ JIRA="CB-????" # Set this to the release bug.
+
+## Update and Pin Dependencies
+Ensure you're up-to-date:
+
+ coho repo-update -r coho
+
+See if any dependencies are outdated
+
+ (cd cordova-coho && npm outdated --depth=0)
+
+Update them in each project's `package.json` file. Make sure to run through the test section below for compatability issues. The `--depth=0` prevents from listing dependencies of dependencies.
+
+## Update Release Notes & Version
+
+Increase the version within package.json using SemVer, and remove the `-dev` suffix
+
+ for l in cordova-coho; do ( cd $l; v="$(grep '"version"' package.json | cut -d'"' -f4)"; if [[ $v = *-dev ]]; then v2="${v%-dev}"; echo "$l: Setting version to $v2"; sed -i '' -E 's/version":.*/version": "'$v2'",/' package.json; fi) ; done
+
+If the changes merit it, manually bump the major / minor version instead of the micro. View the changes via:
+(TODO: need to use coho to get tags for cordova-lib, fetch, common and serve. Current output is incorrect)
+
+ ( cd cordova-coho; git log --pretty=format:'* %s' --topo-order --no-merges $(git describe --tags --abbrev=0)..master)
+
+Update each repo's RELEASENOTES.md file with changes
+
+ coho update-release-notes -r coho
+ # Then curate:
+ vim cordova-coho/RELEASENOTES.md
+
+Commit these changes together into one commit
+
+ for l in cordova-coho; do ( cd $l; v="$(grep '"version"' package.json | cut -d'"' -f4)"; git commit -am "$JIRA Updated version and RELEASENOTES.md for release $v" ); done
+
+## Test
+
+Ensure license headers are present everywhere. For reference, see this [background](http://www.apache.org/legal/src-headers.html). Expect some noise in the output, for example some files from test fixtures will show up.
+
+ coho audit-license-headers -r coho | less
+
+Ensure all dependencies and subdependencies have Apache-compatible licenses
+
+ coho check-license -r coho
+
+
+## Tag
+
+ # Review commits:
+ for l in cordova-coho; do ( cd $l; git log -p origin/master..master ); done
+ # Tag
+ for l in cordova-coho; do ( cd $l; v="$(grep '"version"' package.json | cut -d'"' -f4)"; git tag $v ); done
+
+## Create release branches if they don't yet exist
+If branches don't exist, create new ones
+
+ (cd cordova-coho; git branch 1.0.x)
+
+If branches already exist, update them
+
+ (cd cordova-coho && git checkout 1.0.x && git merge master && git checkout master)
+
+## Re-introduce -dev suffix to versions on master and commit
+
+ for l in cordova-coho; do ( cd $l; v="$(grep '"version"' package.json | cut -d'"' -f4)"; 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":.*/version": "'$v2'",/' package.json; fi); done
+ for l in cordova-coho; do (cd $l; git commit -am "$JIRA Incremented package version to -dev"; git show ); done
+
+## Push
+
+ for l in cordova-coho; do ( cd $l; git push && git push --tags ); done
+
+If the push fails due to not being fully up-to-date, either:
+1. Pull in new changes via `git pull --rebase`, and include them in the release notes / re-tag
+2. Pull in new changes via `git pull`, and do *not* include them in the release.
+
+If you created new release branches, push them as well e.g: `git push origin 1.0.x`
+
+## Publish to dist/dev & npm
+
+Ensure you have the svn repos checked out:
+
+ coho repo-clone -r dist -r dist/dev
+
+Create archives from your tags:
+
+ coho create-archive -r coho --dest cordova-dist-dev/$JIRA
+
+Sanity Check:
+
+ coho verify-archive cordova-dist-dev/$JIRA/*.tgz
+
+Upload:
+
+ (cd cordova-dist-dev && svn add $JIRA && svn commit -m "$JIRA Uploading release candidate for coho release")
+
+Find your release here: https://dist.apache.org/repos/dist/dev/cordova/
+
+## Prepare Blog Post
+ * Combine highlights from RELEASENOTES.md into a Release Announcement blog post
+ * Get blog post proofread via [GitHub](http://github.com/apache/cordova-docs).
+
+## Start VOTE Thread
+Send an email to dev ML with:
+
+__Subject:__
+
+ [Vote] Coho Release
+
+__Body:__
+
+ Please review and vote on this Tools Release
+ by replying to this email (and keep discussion on the DISCUSS thread)
+
+ Release issue: https://issues.apache.org/jira/browse/CB-XXXX
+
+ Coho has been published to dist/dev:
+ https://dist.apache.org/repos/dist/dev/cordova/CB-XXXX/
+
+ The package was published from its corresponding git tag:
+
+ PASTE OUTPUT OF: coho print-tags -r coho
+
+ Upon a successful vote I will upload the archives to dist/, publish them to npm, and post the corresponding blog post.
+
+ Voting guidelines: https://github.com/apache/cordova-coho/blob/master/docs/release-voting.md
+
+ Voting will go on for a minimum of 48 hours.
+
+ I vote +1:
+ * Ran coho audit-license-headers over the coho repo
+ * Ran coho check-license to ensure all coho source has Apache-compatible licenses
+ * Ensured continuous build was green when repos were tagged
+
+
+## Email the result of the vote
+Respond to the vote thread with:
+
+ The vote has now closed. The results are:
+
+ Positive Binding Votes: (# of PMC members that +1'ed)
+
+ .. names of all +1 PMC members ..
+
+ Negative Binding Votes: (# of PMC members that -1'ed)
+
+ .. names of all -1 PMC members ..
+
+ The vote has passed.
+
+_Note: list of PMC members: http://people.apache.org/phonebook.html?pmc=cordova_
+
+## If the Vote does *not* Pass
+
+* git checkout release branch if exists
+* Address the concerns
+* Bump the version number in package.json
+* Create new tag based on new version number
+* Cherry-pick relevant commits to master if applicable
+* Start a new vote
+
+## Otherwise: Publish to dist/
+
+ cd cordova-dist
+ svn up
+ svn rm tools/cordova-coho-*
+ cp ../cordova-dist-dev/$JIRA/* tools/
+ svn add tools/*
+ svn commit -m "$JIRA Published coho release to dist"
+
+ cd ../cordova-dist-dev
+ svn up
+ svn rm $JIRA
+ svn commit -m "$JIRA Removing release candidates from dist/dev"
+ cd ..
+
+Find your release here: https://dist.apache.org/repos/dist/release/cordova/tools
+
+## Publish and test from npm
+
+Publish these to npm
+
+ npm publish cordova-dist/tools/cordova-coho-*.tgz
+
+Test from npm:
+
+ npm -g uninstall cordova-coho
+ npm -g install cordova-coho@latest
+ mkdir test
+ cd test
+ coho repo-clone -g -r tools
+
+### Tell Apache about Release
+
+TODO: Please someone write a coho helper for doing this POST request!
+
+1. Go to: https://reporter.apache.org/addrelease.html?cordova
+2. Use version "cordova-coho@x.x.x"
+
+## Post Blog Post
+
+Follow https://github.com/apache/cordova-docs#deploying
+
+## Email a release announcement to the mailing list
+Subject: [ANNOUNCEMENT] Coho Release
+
+ Cordova-coho@VERSION has been released!
+
+ You can view the release blog post at LINK_TO_BLOG
+
+## Make permanent release tags
+
+Make a copy of your released tag with a prefix of rel\YOURTAG. These are permanent release tags for Apache.
+Do this for all of the tools you just released. For example:
+
+ (cd cordova-coho; git checkout 1.0.0; git tag rel/1.0.0; git push origin --tags; git checkout master)
+
+## Do other announcements
+
+Tweet out blog post and post to #releases in slack
+
+## Update dependencies going forward
+
+ git checkout master
+ npm outdated --depth 0
+
+If there are any dependencies or devDependencies that are out of date, open a Jira item for that tool.
+
+## Close JIRA Issue
+ * Double check that the issue has comments that record the steps you took
+ * Mark it as fixed
+
+## Finally:
+
+ * Update *these instructions* if they were missing anything.
+
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org
[4/4] cordova-coho git commit: Updated README for npm release
Posted by sh...@apache.org.
Updated README for npm release
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/b6fb6b0c
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/b6fb6b0c
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/b6fb6b0c
Branch: refs/heads/master
Commit: b6fb6b0cdb9d11865eedc246be2354e4e5f9a20a
Parents: 7bd24a7
Author: Shazron Abdullah <sh...@gmail.com>
Authored: Wed May 10 15:28:30 2017 -0700
Committer: Shazron Abdullah <sh...@gmail.com>
Committed: Wed May 10 15:28:30 2017 -0700
----------------------------------------------------------------------
README.md | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++--------
1 file changed, 57 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/b6fb6b0c/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 18edd3f..ad3be39 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,9 @@
[](https://travis-ci.org/apache/cordova-coho)
[](https://ci.appveyor.com/project/stumped2/cordova-coho)
-# COHO
+# Cordova Coho
+
+> The command line tool to for Apache Cordova contributors to manage [ Apache Cordova](http://cordova.apache.org) repositories, and to help with releases and pull requests.
This repository has the following purposes:
@@ -36,13 +38,23 @@ This repository has the following purposes:
- e.g. coho repo-clone
- e.g. coho --help
-## How to Install Node:
+## Node.js is a pre-requisite:
+
+Easiest way on OS X & Linux:
+ [https://github.com/creationix/nvm](https://github.com/creationix/nvm)
+
+Easiest way on Windows:
+ [http://nodejs.org/](http://nodejs.org/)
-Easiest way on OS X & Linux: https://github.com/creationix/nvm
+# Installation
-Easiest way on Win: http://nodejs.org/
+```bash
+npm install -g cordova-coho
+```
-## How to Clone & Use `coho`
+On Mac OS X / Linux, if you didn't use a node version manager like `nvm` or `n`, you might have to run the command using `sudo`.
+
+## Alternately, you could also clone & Use `coho`
mkdir -p cordova
cd cordova
@@ -50,9 +62,46 @@ Easiest way on Win: http://nodejs.org/
cd cordova-coho
npm install
npm link # Might need sudo for some configurations
+
+# Cloning Cordova repositories
+
+```bash
+mkdir cordova-repos
+cd cordova-repos
+coho repo-clone -g -r all
+```
+
+This will clone **all** Apache Cordova repositories into the current working directory.
+
+# Docs
+
coho --help
-## How to Clone Other Repos
+or if you know the command:
+
+
+ coho [command] --help
+
+For example:
+
+ coho repo-clone --help
+
+To see valid repo ids and repo group ids for use with Coho, use the `list-repos` command:
+
+ coho list-repos
+
+
+# Contributing
+Cordova is an open source Apache project and contributors are needed to keep this project moving forward. Learn more on
+[how to contribute on our website][contribute].
+
+# TO-DO + Issues
+
+If you find issues with this tool, please follow our guidelines for [reporting issues].
+We do not use github issue system as an Apache project, we have a JIRA issue management system which covers over 50+ cli, platform,
+plugin repos in the Cordova project. Use the "cordova-coho" component for Cordova Coho issues.
+
+Note that for some commands you may need to use the `-g` or `--global` flag to work in an npm global context, since coho was originally designed for use in another context.
- coho repo-clone -r plugins -r tools -r android -r ios -r ...
- coho npm-link
+[Contribute]: http://cordova.apache.org/contribute/
+[Reporting issues]: http://cordova.apache.org/contribute/issues.html
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org
[3/4] cordova-coho git commit: Added empty RELEASENOTES.md
Posted by sh...@apache.org.
Added empty RELEASENOTES.md
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/7bd24a70
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/7bd24a70
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/7bd24a70
Branch: refs/heads/master
Commit: 7bd24a70b8893ae48a2c01f3affc964c5cb1a5e9
Parents: bf5470d
Author: Shazron Abdullah <sh...@gmail.com>
Authored: Wed May 10 15:28:16 2017 -0700
Committer: Shazron Abdullah <sh...@gmail.com>
Committed: Wed May 10 15:28:16 2017 -0700
----------------------------------------------------------------------
RELEASENOTES.md | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/7bd24a70/RELEASENOTES.md
----------------------------------------------------------------------
diff --git a/RELEASENOTES.md b/RELEASENOTES.md
new file mode 100644
index 0000000..8a8ba9f
--- /dev/null
+++ b/RELEASENOTES.md
@@ -0,0 +1,20 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org