-
Notifications
You must be signed in to change notification settings - Fork 319
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
Build docs with warnings as errors #882
Conversation
Unlike locally this fails on travis. Probably due to a much older version of pandoc |
So now (post e8367b9) this PR is rather a cleanup up the docs build process than an enforcing that there are no warnings? |
@WilliamHPNielsen not really post that it's an attempt to find a way to fix the warnings before flipping the switch back again 😃 |
This reverts commit e8367b9.
Which I think it does now 🤞 |
Awesome! |
@@ -24,6 +24,9 @@ install: | |||
- pip install -r requirements.txt | |||
- pip install -r test_requirements.txt --upgrade | |||
- pip install -r docs_requirements.txt | |||
# Install a new version of Sphinx that correctly handles forward refs once 1.7.0 is out that should | |||
# be used instead | |||
- pip install git+https://github.com/jenshnielsen/sphinx.git@working_forward_ref --upgrade |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
No it's not great. The alternative is to wait for 1.7.0 to be released
@jenshnielsen I think we can merge it. Or would you prefer to wait for the next sphinx release? |
Lets merge I would say |
Once this is merged we need to be extra careful that all branches are up to date with master before merging to not break master |
Author: Jens Hedegaard Nielsen <jenshnielsen@gmail.com> Build docs with warnings as errors (#882)
Prevent Sphinx syntax errors to creep into the docs and fix all remaining warnings
Also
Add missing .PHONY to makefile
@WilliamHPNielsen