## Releasing Shopify CLI

1. Check the Semantic Versioning page for info on how to version the new release: http://semver.org

2. Create a branch named `release_X_Y_Z` (replacing `X_Y_Z` with the intended release version)
   ```
   $ git checkout -b release_X_Y_Z
   ```

3. Update the version of Shopify CLI in `lib/shopify-cli/version.rb`

4. Add an entry for the new release to `CHANGELOG.md`

5. Commit the changes with a commit message like "Packaging for release X.Y.Z"
   ```
   $ git commit -am "Packaging for release vX.Y.Z"
   ```

6. Push out the changes
   ```
   $ git push -u origin release_X_Y_Z
   ```

7. Open a PR for the branch, get necessary approvals from code owners and merge into main branch. Note that the PR title will be the release note in Shipit, so make sure it mentions the release

8. Deploy using Shipit

9. On local machine and _AFTER_ gem has been published to https://rubygems.org, run
   ```
   $ rake package
   ```
   This will generate the `.deb`, `.rpm` and brew formula files, which will be located in `packaging/builds/X.Y.Z/`.

10. Clone the `Shopify/homebrew-shopify` repository (if not already cloned), and then
    * create a branch named `release_X_Y_Z_of_shopify-cli`
    * update the brew formula in `shopify-cli.rb` with the generated formula in `packaging/builds/X.Y.Z/` in the `Shopify/shopify-app-cli` repo (from step 9)
    * commit the change and create a PR on the [Shopify Homebrew repository](https://github.com/Shopify/homebrew-shopify)
    * when PR is approved, merge into main branch

11. Go to [releases](https://github.com/Shopify/shopify-app-cli/releases) page of `Shopify/shopify-app-cli` repo and create a new release:
    * use the tag created in step 8 by Shipit (should be "vX.Y.Z")
    * release title = "Version X.Y.Z"
    * description should be 
      ```
      Release of version X.Y.Z of Shopify App CLI
    
      Please refer to [CHANGELOG](https://github.com/Shopify/shopify-app-cli/blob/master/CHANGELOG.md) for details.
      ```
    * upload the `.deb` and `.rpm` files from `packaging/builds/X.Y.Z/` (generated in step 9)
    * if it's a pre-release version, select the "This is a pre-release" checkbox
    * and click "Publish release".