RELEASE.md

Release steps

1. Create a release branch

1. Before merging a feature, create a release branch for the next target version, e.g.

   git checkout trunk
   git checkout -b planned-release/0.2.1

2. In GitHub, select the base branch as the planned-release/... branch.

3. Merge feature branches into the planned-release/... branch.

2. Update build files

composer install --no-dev

Note: If new production dependencies have been added, modify the root .gitignore file to include new vendor/ subfolders.

Now commit these build changes in.

3. Bump plugin version

1. When the version is ready for release, inside the planned-release/... branch, bump the version number in vip-decoupled.php.
2. Create a PR for the planned release branch (e.g. "Planned release 0.2.1") and merge to trunk.

4. Tag branch for release

1. In trunk, add a tag for the release:

   git checkout trunk
   git pull
   git tag -a <version> -m "Release <version>"
   
   # e.g. git tag -a 1.0.2 -m "Release 1.0.2"

2. Run git push --tags.

5. Create a release

1. In the vip-decoupled-bundle folder, run this command to create a plugin ZIP:

   git archive --prefix "vip-decoupled-bundle/" <version> -o vip-decoupled-bundle-<version>.zip
   
   # e.g. git archive --prefix "vip-decoupled-bundle/" 1.0.2 -o vip-decoupled-bundle-1.0.2.zip
   #
   # Creates a ZIP archive with the prefix folder "vip-decoupled-bundle/" containing files from tag 1.0.2

2. Visit the vip-decoupled-bundle create release page.

3. Select the newly created version tag in the dropdown.

4. For the title, enter the release version name (e.g. 1.0.2)

5. Add a description of release changes.

6. Attach the plugin ZIP.

7. Click "Publish release."