Publishing documentation
Contents
Publishing documentation#
You can publish the documentation to a GitHub Pages, but this tutorial will show you how to use Read the Docs.
Readthedocs#
Ensure that your project has a docs/requirements.txt file with all
Python packages needed to build the documentation. Optionally, add
configuration options
to the file .readthedocs.yaml.
Go to readthedocs.org and sign in or make an acount
Go to your Dashboard and Import a Project
To Import Manually, enter your project details into the form
Or,
Go to Connected Services and connect your GitHub, GitLab, or Bitbucket account
Find your repository and click the plus icon
You should now be able to view your documentation live on the internet! It will update every time you push to the specified branch, so ensure that your documentation compiles correctly before publishing.