Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix readthedocs builds, update copyright year & Writing Docs page #142

Merged
merged 4 commits into from
Jan 25, 2024

Conversation

JOJ0
Copy link
Contributor

@JOJ0 JOJ0 commented Jan 24, 2024

Fixes #136

Add .readthedocs.yaml to fix rtd-builds and add docs requirements (replacing sphinx_requirements.txt) via extras section in setup.py.

This ignores our Jinja2 version fixation! Let's see if that works!

Also some wording changes in our "Writing docs section".

In enabled this PR's branch to review the changes and the succesful build: https://python3-discogs-client.readthedocs.io/en/fix_readthedocs/writing_docs.html

Build on RTD seems to be fine. Sphinx autodoc worked as well (that was IIRC the reason we had Jinja2 fixated to a specific version in the now deleted sphinx_requirements.txt.)

Add .readthedocs.yaml to fix rtd-builds and add docs requirements
(replacing sphinx_requirements.txt) via extras section in setup.py.

This ignores our Jinja2 version fixation! Let's see if that works!
we install via setuptools "extras_require" now.
@JOJ0
Copy link
Contributor Author

JOJ0 commented Jan 24, 2024

@prcutler @alifhughes @AnssiAhola this is just an FYI, I don't need a real review! I verified everything and think it's fine. I'll doublecheck and merge tomorrow or so.

@prcutler
Copy link
Contributor

There is one typo in the "Build the Documentation "section:

It says:

We reommend using Python 3.9 or Python 3.11 for building the documentation.

Should be: 'We recommend'

Otherwise looks good to me!

@JOJ0 JOJ0 changed the title Fix readthedocs builds Fix readthedocs builds, update copyright year & Writing Docs page Jan 25, 2024
@JOJ0 JOJ0 merged commit 6153797 into master Jan 25, 2024
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Migrate readthedocs build to new method
2 participants