pgrondek/polybar-dwm
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve release workflow documentation

Browse Source
This commit is contained in:
patrick96 2023-11-05 21:57:36 +01:00
parent 70c400d20d
commit ea3b47a65e
No known key found for this signature in database
GPG Key ID: 521E5E03AEBCA1A7
1 changed files with 28 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/dev/release-workflow.rst
View File

@ -90,8 +90,8 @@ branch and cherry-picks the bugfix commits.
Alternatively, the contributor can also ``git rebase --onto`` to base the Alternatively, the contributor can also ``git rebase --onto`` to base the
branch off the previous release tag. However, in most cases it makes sense for branch off the previous release tag. However, in most cases it makes sense for
a maintainer to create the release branch since they will also need to add a a maintainer to create the release branch since they will also need to create
`Release Commit`_ to it. a `Release PR`_ for it.
Once the release branch is created and contains the right commits, the Once the release branch is created and contains the right commits, the
maintainer should follow `Publishing a new Release`_ to finish this patch maintainer should follow `Publishing a new Release`_ to finish this patch
@ -110,8 +110,7 @@ Publishing a new Release
The process for publishing a release is the same for all release types. It goes The process for publishing a release is the same for all release types. It goes
as follows: as follows:
* A `Release commit`_ is added to the tip of the release branch. * A `Release PR`_ is created for the release. This PR MUST NOT be merged in
* A draft PR is opened for the release branch. This PR MUST NOT be merged in
GitHub's interface, it is only here for review, merging happens at the GitHub's interface, it is only here for review, merging happens at the
commandline. commandline.
* After approval, a signed git tag is created locally at the tip of the release * After approval, a signed git tag is created locally at the tip of the release
@ -143,16 +142,23 @@ as follows:
Here ``<release-branch>`` is either a ``release/X.Y.0`` branch or a Here ``<release-branch>`` is either a ``release/X.Y.0`` branch or a
``hotfix/X.Y.Z`` branch. ``hotfix/X.Y.Z`` branch.
Release Commit Release PR
~~~~~~~~~~~~~~ ~~~~~~~~~~
When merging, a release commit must be at the tip of the release branch. The final state of the release branch is prepared as a draft PR on
GitHub.
That PR is not merged from the GitHub interface though.
The release commit needs to update the version number in: The release PR must do the following things:
* ``version.txt`` * Write any missing migration guides for:
The release commit must also finalize the `Changelog`_ for this release. * Deprecated or removed options
* New features that it might be worth migrating to
* Have a release commit at its tip with the message ``Version X.Y.Z`` and the following changes
* Finalizes the `Changelog`_ for this release
* Updates the version number in ``version.txt``
Changelog Changelog
~~~~~~~~~ ~~~~~~~~~
@ -209,6 +215,13 @@ In addition using GitHub's "Auto-generate release notes" feature, the list of
new contributors should be generated and put at the end of the release notes. new contributors should be generated and put at the end of the release notes.
The generated list of PRs can be removed. The generated list of PRs can be removed.
For minor and major releases, add a link to the migration guide directly under
the ``## Changelog`` header:
.. code-block:: markdown
**[Migration Guide](https://polybar.readthedocs.io/en/stable/migration/X.Y/index.html)**
At the bottom, check the two boxes "Set as the latest release" and "Create a At the bottom, check the two boxes "Set as the latest release" and "Create a
discussion for this release" (select the category "Announcements"). discussion for this release" (select the category "Announcements").
@ -216,9 +229,11 @@ After-Release Checklist
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
* Verify the release archive (see `Verify Release`_) * Verify the release archive (see `Verify Release`_)
* Make sure all the new functionality is documented on the wiki * Update the Wiki
* Make sure all the new functionality is documented
* Mark deprecated features appropriately (see `Deprecations`_) * Mark deprecated features appropriately (see `Deprecations`_)
* Remove all unreleased notes from the wiki (not for patch releases) * Remove all "unreleased" notes (not for patch releases)
* Inform packagers of new release in :issue:`1971`. Mention any dependency * Inform packagers of new release in :issue:`1971`. Mention any dependency
changes and any changes to the build workflow. Also mention any new files are changes and any changes to the build workflow. Also mention any new files are
created by the installation. created by the installation.