Releasing and Publishing TrueLearn#
This document is intended for the core maintainers of the project.
Publishing to PyPI#
Make sure the secrets and tokens are setup correctly for the GitHub Actions.
When a new release is created the
Upload Python Package action automatically deploys to
TestPyPi. This is to ensure that any issues can be identified before the official release.
After checking the package on TestPyPi run the upload python package workflow manually,
pypi in the inputs box. TrueLearn will then be packaged and available on PyPi!
The release process is as follows:
Create a new branch for the release named
On the release branch, set the version number in the
Commit the changes.
Open a pull request to merge into main.
Once approved, merge the pull request.
Then create a new tag for the release named
Create a new release on GitHub with that tag with the title as
TrueLearn <version>and target the ‘main’ branch. The release notes should be copied from the
Read the Docs will build the documentation. The documentation will be available at http://truelearn.readthedocs.org/en/<version>/ and the stable version will be updated to the latest release.
You may need to activate the new version in the Read the Docs dashboard.
At this stage follow the instructions in the Publishing to PyPI section.
Only do this after the release has been published to PyPI. Otherwise the version number will be incorrect.
In the main branch update the version number in the
truelearn/__init__.py file to the
next version number and add the
-dev suffix. Also update the
CHANGELOG.rst file to add a new section for the next version.