- Branch: Starting from
develop, cut a release branch namedrelease/X.Y.Zfor your changes. - Changelog: Add/update the changelog in
CHANGELOG.md. - Props: update
CREDITS.mdfile with any new contributors, confirm maintainers are accurate. - Readme updates: Make any other readme changes as necessary in
README.md. - Merge: Make a non-fast-forward merge from your release branch to
develop(or merge the pull request), then mergedevelopintostable(git checkout stable && git merge --no-ff develop). - Push: Push your stable branch to GitHub (e.g.
git push origin stable). - Release: Create a new release, naming the tag and the release with the new version number, and targeting the
stablebranch. Paste the changelog fromCHANGELOG.mdinto the body of the release and include a link to the closed issues on the milestone. The release should now appear under releases. - Ensure the release appears in the GitHub Marketplace correctly.
- Close milestone: Edit the milestone with release date (in the
Due date (optional)field) and link to GitHub release (in theDescription field), then close the milestone. - Punt incomplete items: If any open issues or PRs which were milestoned for
X.Y.Zdo not make it into the release, update their milestone toX.Y.Z+1,X.Y+1.0,X+1.0.0orFuture Release. - Celebrate shipping!