- Branch: Starting from
develop
, cut a release branch namedrelease/X.Y.Z
for your changes. - Changelog: Add/update the changelog in
CHANGELOG.md
. - Props: update
CREDITS.md
file 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 mergedevelop
intostable
(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
stable
branch. Paste the changelog fromCHANGELOG.md
into 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.Z
do not make it into the release, update their milestone toX.Y.Z+1
,X.Y+1.0
,X+1.0.0
orFuture Release
. - Celebrate shipping!