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

feanil/fix rtd file #419

Merged
merged 3 commits into from
Dec 6, 2023
Merged

feanil/fix rtd file #419

merged 3 commits into from
Dec 6, 2023

Conversation

feanil
Copy link
Contributor

@feanil feanil commented Dec 6, 2023

  • fix: Update the .readthedocs.yml file to correct the config.
  • fix: RTD prefers .yaml instead of .yml.

Fixes #416

There have been requirements changes for this file from the RTD side.

Some more details on these changes: https://blog.readthedocs.com/use-build-os-config/

Also we should fail or warnings by default as sphinx warnings generally
point out important documentation functionality issues like missing docs
or broken links.
@dianakhuang dianakhuang mentioned this pull request Dec 6, 2023
6 tasks
@@ -8,8 +8,14 @@ version: 2
# Build documentation in the docs/ directory with Sphinx
sphinx:
configuration: docs/conf.py
fail_on_warning: true
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you update https://github.com/openedx/edx-cookiecutters/blob/master/CHANGELOG.rst, and especially note this fail on warning change, in addition to the fixes to read the docs builds?

@feanil feanil merged commit 591d614 into master Dec 6, 2023
5 checks passed
@feanil feanil deleted the feanil/fix_rtd_file branch December 6, 2023 20:59
andrey-canon added a commit to nelc/event-routing-backends that referenced this pull request Dec 6, 2023
@robrap
Copy link
Contributor

robrap commented Dec 6, 2023

[inform] This might be broken. I had updated edx-drf-extensions to work like edx-platform, and now I tried simplifying the python install to match this cookiecutter update and it broke on Django. See openedx/edx-drf-extensions#415

@feanil
Copy link
Contributor Author

feanil commented Dec 7, 2023

It looks like the failure there is because it's referencing django but not actually including it as a docs requirement and not related to the RTD config.

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.

Readthedocs config template is broken
3 participants