Release Process

Prepping for release:

1. Download the woorelease.zip from the latest release, and store the phar somewhere locally.

2. Create a release branch off of develop branch, or cherry-pick commits onto the branch

git checkout develop
git checkout -b release/x.x.x

Gather changelog from develop

1. run: woorelease cl:generate --product_version=x.x.x https://github.com/woocommerce/pinterest-for-woocommerce/tree/develop
2. Copy the entries and store them somewhere to be used in the final release.

⚠️ That still misses the entries from other branches, forks, and PR-to-PRs. You may redo this step for other branches, or inspect the list of all commits for "Merge pull request …", and check manually.

Simulated release

product_version=<new version to be released>

# The following is optional for when a newer version of WC or WP has been released.
# More info: https://github.com/woocommerce/woorelease/wiki/Usage
wc_tested=<latest compatible WC version>
wp_tested=<latest compatible WP version>

# Branch should be a release branch
woorelease simulate --product_version=x.x.x --wc_tested=y.y --generate_changelog https://github.com/woocommerce/pinterest-for-woocommerce/tree/release/x.x.x

Note: Select y when prompted "Would you like to add/delete them in the svn working copy?"

Check build

1. Check temporary folder for pinterest-for-woocommerce.zip
2. Install zip file on a test site
3. Confirm it activates without warnings/errors and is showing the right versions
4. Run a few basic smoke tests

Final release

1. Run:

woorelease release --product_version=x.x.x --wc_tested=y.y --generate_changelog https://github.com/woocommerce/pinterest-for-woocommerce/tree/release/x.x.x

2. When prompted for changelog entries add the ones copied from the develop branch.
3. Create a PR to merge release branch back to trunk and develop. Example: https://github.com/woocommerce/pinterest-for-woocommerce/pull/439