Skip to content

Latest commit

 

History

History
109 lines (69 loc) · 3.25 KB

RELEASE.md

File metadata and controls

109 lines (69 loc) · 3.25 KB
Raw

Release Manager's Guide

Release Process:

  1. Bump version and update tag.
  2. Update changelog and render towncrier fragments.
  3. Release beta or rc.
  4. Run benchmark and check for regressions.
  5. Review and edit doc changes since the last release for clarity and consistency.
  6. Publish final version and add a release note.
  7. Run benchmark and update falconframework.org with latest numbers.
  8. Announce the new version in Gitter channels and on the socials.

Bump version and update tag

Modify falcon/version.py if it has not been updated since the previous release. Examine the rendered changelog to determine the appropriate SEMVER field to modify.

Update changelog filename in pyproject.toml to suit.

Update the build tag in setup.cfg under [egg_info] for pre-release builds, or remove it (leaving it blank as in tag_build = ) for a final releases.

Update changelog and render towncrier fragments

If a changelog RST has not yet been created, add one under docs/changes using the following template, and update the summary and changes to supported platforms to suit:

Changelog for Falcon 3.0.1
==========================

Summary
-------

This is a minor point release to take care of a couple of bugs that we did
not catch for 3.0.0.

Changes to Supported Platforms
------------------------------

- CPython 3.10 is now fully supported. (`#1966 <https://github.com/falconry/falcon/issues/1966>`__)
- Support for Python 3.6 is now deprecated and will be removed in Falcon 4.0.
- As with the previous release, Python 3.5 support remains deprecated and will
  no longer be supported in Falcon 4.0.


.. towncrier release notes start

Contributors to this Release
----------------------------

Many thanks to those who contributed to this bugfix release:

Otherwise, ensure the summary has been brought up to date; be sure to highlight key changes in this release.

Next update the contributors and render towncrier fragments by running:

$ tox -e changelog_release

Examine the updated RST as well as the rendered HTML docs and make any adjustments as needed. On OS X it's as simple as:

.. code:: bash

$ open docs/_build/html/changes/index.html

Or on Linux:

.. code:: bash

$ xdg-open docs/_build/html/changes/index.html

If you need to go back and make any additional tweaks, just git restore docs/changes and re-run the tox command when ready for another proofreading. Or if you just made a manual edit to the changelog RST, you can simply re-render the docs:

.. code:: bash

$ tox -e docs

If all looks good, remove the rendered towncrier fragments from docs/_newsfragments and then submit a PR containing the changes made so far.

Release beta or rc

Be sure to install and test from PyPI as a sanity check afterwards. Fix docs, performance regressions, and reported bugs (if any) and release additional betas or release candidates.

Run benchmark and check for regressions

TODO: Replace with CI gate

Review and edit doc changes since the last release for clarity and consistency

Publish final version and add a release note

Be sure to install and test from PyPI as a sanity check afterwards.

Run benchmark and update falconframework.org with latest numbers

Announce the new version in Gitter channels and on the socials.