p5.js-web-editor/developer_docs/release.md

# Release

A guide for creating a release.

## Background
This project release guide is based on 
* [git-flow](https://nvie.com/posts/a-successful-git-branching-model/)
* [Semantic Versioning (semver)](https://semver.org/)
* [npm-version](https://docs.npmjs.com/cli/version)
* [Let's stop saying Master/Slave](https://medium.com/@mikebroberts/let-s-stop-saying-master-slave-10f1d1bf34df)

## Steps
1. `$ git checkout develop`
2. `$ git checkout -b release-<newversion>`
3. Do all of the release branch testing necessary. This could be as simple as running `npm test:ci`, or it could take user testing over a few days. 
4. `$ git checkout release`
5. `$ git merge --no-ff release-<newversion>`
6. `$ npm version <newversion>` (see [npm-version](https://docs.npmjs.com/cli/version) for valid values of <newversion>).
7. `$ git push && git push --tags`
8. `$ git checkout develop`
9. `$ git merge --no-ff release-<newversion>`
10. Create a release on GitHub. You can do this in one of two ways:
    1.  (Preferred) Use the [`hub` command line tool](https://hub.github.com/). You can automate adding all commit messages since the last release with the following command:
        ```sh
        $ hub release create -d -m "<newversion>" -m "$(git log `git describe --tags --abbrev=0 HEAD^`..HEAD --oneline)" <newversion>`
        ```
        Note that this creates a draft release, which you can then edit on GitHub. This allows you to create release notes from the list of commit messages, but then edit these notes as you wish.
    2.  [Draft a new release on Github](https://github.com/processing/p5.js-web-editor/releases/new).

Travis CI will automatically deploy the release to production, as well as push a production tagged Docker image to DockerHub.
Update travis.yml with new branch names, add git flow to development and release guides 2020-05-21 21:00:27 +00:00			`# Release`

			`A guide for creating a release.`

			`## Background`
			`This project release guide is based on`
			`* [git-flow](https://nvie.com/posts/a-successful-git-branching-model/)`
			`* [Semantic Versioning (semver)](https://semver.org/)`
			`* [npm-version](https://docs.npmjs.com/cli/version)`
Update release guide with git flow steps, update Travis deployment to use git tag 2020-05-21 21:43:58 +00:00			`* [Let's stop saying Master/Slave](https://medium.com/@mikebroberts/let-s-stop-saying-master-slave-10f1d1bf34df)`
Update travis.yml with new branch names, add git flow to development and release guides 2020-05-21 21:00:27 +00:00
			`## Steps`
Update release guide with git flow steps, update Travis deployment to use git tag 2020-05-21 21:43:58 +00:00			1. `$ git checkout develop`
			2. `$ git checkout -b release-<newversion>`
			3. Do all of the release branch testing necessary. This could be as simple as running `npm test:ci`, or it could take user testing over a few days.
			4. `$ git checkout release`
			5. `$ git merge --no-ff release-<newversion>`
			6. `$ npm version <newversion>` (see [npm-version](https://docs.npmjs.com/cli/version) for valid values of <newversion>).
			7. `$ git push && git push --tags`
			8. `$ git checkout develop`
			9. `$ git merge --no-ff release-<newversion>`
RE: #1421, Add documentation about creating a GitHub release after creating a tag 2020-06-01 19:31:59 +00:00			`10. Create a release on GitHub. You can do this in one of two ways:`
			1. (Preferred) Use the [`hub` command line tool](https://hub.github.com/). You can automate adding all commit messages since the last release with the following command:
			```sh
			$ hub release create -d -m "<newversion>" -m "$(git log `git describe --tags --abbrev=0 HEAD^`..HEAD --oneline)" <newversion>`
			```
			`Note that this creates a draft release, which you can then edit on GitHub. This allows you to create release notes from the list of commit messages, but then edit these notes as you wish.`
			`2. [Draft a new release on Github](https://github.com/processing/p5.js-web-editor/releases/new).`
Update release guide with git flow steps, update Travis deployment to use git tag 2020-05-21 21:43:58 +00:00
			`Travis CI will automatically deploy the release to production, as well as push a production tagged Docker image to DockerHub.`