# How to cut a new release

1. Create a release branch.
  ```bash
  git checkout -b release-1.x.x # (where 1.x.x reflects the release)
  ```
2. Update package.json with the version number
3. Build the release
  ```bash
  yarn release
  ```
4. Update the changelog

  ```bash
  # Copy the output of the command below and paste it into CHANGELOG.md
  # following the conventions of that file 
  yarn changelog-maker postlight mercury-parser 
  ```
5. Submit a PR
6. Merge once the PR's tests pass
7. [Create a release](https://github.com/postlight/mercury-parser/releases), linking to this release's entry in the changelog. (See other releases for context.)