mithril-vndb/docs/releasing.md
2017-05-01 22:46:23 -07:00

2.3 KiB

Mithril Release Processes

Releasing a new Mithril version

Prepare the release

  1. Ensure your local branch is up to date
$ git co next
$ git pull --rebase lhorie next
  1. Determine patch level of the change
  2. Update information in docs/change-log.md to match reality of the new version being prepared for release
  3. Commit changes to next
$ git add .
$ git commit -m "Preparing for release"

# Push to your branch
$ git push

# Push to lhorie/mithril.js
$ git push lhorie next

Merge from next to master

  1. Switch to master and make sure it's up to date
$ git co master
$ git pull --rebase lhorie master
  1. merge next on top of it
$ git merge next
  1. Clean & update npm dependencies and ensure the tests are passing.
$ npm prune
$ npm i
$ npm test

Publish the release

  1. npm run release <major|minor|patch|semver>, see the docs for npm version
  2. The changes will be automatically pushed to your fork
  3. Push the changes to lhorie/mithril.js
$ git push lhorie master
  1. Travis will push the new release to npm & create a GitHub release

Merge master back into next

This helps to ensure that the version field of package.json doesn't get out of date.

  1. Switch to next and make sure it's up to date
$ git co next
$ git pull --rebase lhorie next
  1. Merge master back onto next
$ git merge master
  1. Push the changes to your fork & lhorie/mithril.js
$ git push
$ git push lhorie next

Update the GitHub release

  1. The GitHub Release will require a manual description & title to be added. I suggest coming up with a fun title & then copying the docs/change-log.md entry for the build.

Updating mithril.js.org

Fixes to documentation can land whenever, updates to the site are published via Travis.

# These steps assume that lhorie/mithril.js is a git remote named "lhorie"

# Ensure your next branch is up to date
$ git co next
$ git pull lhorie next

# Splat the docs folder from next onto master
$ git co master
$ git co next -- ./docs

# Manually ensure that no new feature docs were added

$ git push lhorie

After the Travis build completes the updated docs should appear on https://mithril.js.org in a few minutes.