-
Notifications
You must be signed in to change notification settings - Fork 3
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 Sphinx warnings #157
Fix Sphinx warnings #157
Conversation
.gitignore
Outdated
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.
Added a line to .gitignore
so I don't accidentally publish by docs environment
for more information, see https://pre-commit.ci
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.
Added the contents of install_developer.rst
here for two reasons. First, it consolidates our scattered installation a bit. Secondly, it cleared the following warnings:
/home/sandboxes/vcatlett/repos/github/dysh/docs/source/for_developers/install_developer.rst:12: WARNING: duplicate label dysh1, other instance in /home/sandboxes/vcatlett/repos/github/dysh/docs/source/for_developers/install.rst
/home/sandboxes/vcatlett/repos/github/dysh/docs/source/for_developers/install_developer.rst:81: WARNING: duplicate label dysh2, other instance in /home/sandboxes/vcatlett/repos/github/dysh/docs/source/for_developers/install.rst
/home/sandboxes/vcatlett/repos/github/dysh/docs/source/for_developers/install_developer.rst:122: WARNING: duplicate label dysh3, other instance in /home/sandboxes/vcatlett/repos/github/dysh/docs/source/for_developers/install.rst
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.
See the comment on the changes to docs/source/for_developers/install.rst
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.
Added a space to resolve this error:
/home/sandboxes/vcatlett/repos/github/dysh/docs/source/getting_started/tutorials/GBT/index.rst:5: ERROR: Error in "toctree" directive:
invalid option block... toctree::
:maxdepth: 2
tutorial-positionswitch
""" | ||
Plot a spectrum using matplotlib | ||
""" |
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.
?
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.
Ah, I just added line breaks to the file's docstring because I think it looks better
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.
@tchamberlin & @vcatlett has this been resolved?
Co-authored-by: Thomas Chamberlin <[email protected]>
Small changes to fix
sphinx-autobuild
warnings. Will comment details on the individual changes.