[INFO] How Branching works for Packages

st2-packages repo now follows st2 branching strategy. What it means.

The Logic:

• Inside st2-packages repo:
  • pushing to master of st2-packages repo will generate packages based on master of st2
  • pushing to v1.3 of st2-packages repo will generate packages based on v1.3 of st2
  • opening PR against master branch of st2-packages repo will use st2 master code
  • opening PR against v1.3 branch of st2-packages repo will use st2 v1.3 code
  • opening PR against any other branch of st2-packages repo will use ST2_GITREV hardcoded version in circle.yml
• Inside st2 repo:
  • pushing to master of st2 repo will generate packages based on master of st2-packages
  • pushing to v1.3 of st2 repo will generate packages based on v1.3 of st2-packages
  • note that we don't enable CircleCI Pull Requests in st2 repo yet

Rebuild the Package Manually:

Normally pushing to v1.3 branch for any st2 or st2-packages repos will generate and deploy v1.3 staging packages.
Usually that's enough, but if you want to do that manually without pushing changes, just use CircleCI rebuild:

• 1.) Navigate to v1.3 branch builds https://circleci.com/gh/StackStorm/st2-packages/tree/v1.3
• 2.) Find latest build
• 3.) Click Rebuild

The issue body documents branching behavior between st2 and st2-packages and manual CircleCI rebuilds, but names no documentation file or requested change. First locate where these instructions are maintained, then confirm the intended documentation update and its completion criteria with the project maintainers.