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

Use sphinx todo for currently empty sections of docs #654

Merged
merged 4 commits into from Apr 21, 2021

Conversation

aaronayres35
Copy link
Contributor

@aaronayres35 aaronayres35 commented Apr 12, 2021

This PR adds various .. todo:: statements across the docs to prevent empty sections from being shown in the built docs.

Note this generates additional sphinx warnings which I am unsure how to resolve currently
These were warnings of the form "Unexpected Section Title" and commenting out the section titles inside the todo blocks got rid of them

@aaronayres35 aaronayres35 changed the title [WIP] Use sphinx todo Use sphinx todo for currently empty sections of docs Apr 16, 2021
@rahulporuri rahulporuri added this to In progress in Enthought OSS Q2 2021 Apr 21, 2021
Copy link
Contributor

@rahulporuri rahulporuri left a comment

Choose a reason for hiding this comment

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

LGTM. I don't think we need an issue right now but if we don't address all of the TODO items before the upcoming release (which is possible), we will want to create one.

@aaronayres35 aaronayres35 merged commit 68fdf0e into master Apr 21, 2021
@aaronayres35 aaronayres35 deleted the use-sphinx-todo branch April 21, 2021 11:59
@rahulporuri rahulporuri moved this from In progress to Done in Enthought OSS Q2 2021 Apr 21, 2021
@rahulporuri rahulporuri moved this from Done to Sprint 2 : 19 April - 30 April 2021 in Enthought OSS Q2 2021 May 3, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
No open projects
Enthought OSS Q2 2021
  
Sprint 2 : 19 April - 30 April 2021
Development

Successfully merging this pull request may close these issues.

None yet

2 participants