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

Build docs with warnings as errors #882

Merged
merged 18 commits into from
Dec 6, 2017

Conversation

jenshnielsen
Copy link
Collaborator

Prevent Sphinx syntax errors to creep into the docs and fix all remaining warnings

  1. Change names of some notebooks due to Converting notebooks with spaces in their names to RST gives broken images ipython/ipython#5350
  2. Correct some wrongly formatted autodoc syntax
  3. Move import of matplotlib, to set backend, to the top which makes it really work.
  4. Use an unreleased version of Sphinx to fix various issues
  5. Clear invalid output of one notebook

Also

Add missing .PHONY to makefile

@WilliamHPNielsen

@jenshnielsen
Copy link
Collaborator Author

Unlike locally this fails on travis. Probably due to a much older version of pandoc

@WilliamHPNielsen
Copy link
Contributor

So now (post e8367b9) this PR is rather a cleanup up the docs build process than an enforcing that there are no warnings?

@jenshnielsen
Copy link
Collaborator Author

@WilliamHPNielsen not really post that it's an attempt to find a way to fix the warnings before flipping the switch back again 😃

@jenshnielsen
Copy link
Collaborator Author

Which I think it does now 🤞

@WilliamHPNielsen
Copy link
Contributor

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
Copy link
Contributor

Choose a reason for hiding this comment

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

Nice!

Copy link
Collaborator Author

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

@WilliamHPNielsen
Copy link
Contributor

@jenshnielsen I think we can merge it. Or would you prefer to wait for the next sphinx release?

@jenshnielsen
Copy link
Collaborator Author

Lets merge I would say

@jenshnielsen
Copy link
Collaborator Author

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

@WilliamHPNielsen WilliamHPNielsen merged commit b9ab98d into microsoft:master Dec 6, 2017
@jenshnielsen jenshnielsen deleted the improve_docs branch December 6, 2017 10:40
giulioungaretti pushed a commit that referenced this pull request Dec 6, 2017
Author: Jens Hedegaard Nielsen <jenshnielsen@gmail.com>

    Build docs with warnings as errors (#882)
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.

2 participants