-
Notifications
You must be signed in to change notification settings - Fork 1
Read the Docs Settings
John T. Wodder II edited this page Nov 25, 2020
·
1 revision
-
If a project has any Sphinx documentation files, they should be hosted online on readthedocs.org, ideally at a subdomain with the same name as the project.
-
Read the Docs sites should be configured as follows:
- "Advanced Settings" page:
- Under "Global settings":
- Set "Default version" to "stable" once at least one release with documentation has been made
- Under "Default settings":
- "Documentation Type" — "Sphinx HTML"
- "Requirements File" - "docs/requirements.txt"
- "Python Interpreter" — "CPython 3.x"
- Check "Install Project"
- Check "Enable PDF Build"
- Check "Enable EPUB Build"
- Under "Global settings":
- "Notifications" page:
- Configure notifications to be sent to my e-mail address on build failures
- "Advanced Settings" page:
-
Tagged versions should always be active
-
latest
andstable
should be active but notmaster