-
Notifications
You must be signed in to change notification settings - Fork 39
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
CLI documentation page generation #342
Conversation
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.
Looks fine, just a few small clarifications and the latest changes on dev
need to be merged in.
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## dev #342 +/- ##
==========================================
+ Coverage 89.34% 89.88% +0.53%
==========================================
Files 12 12
Lines 929 929
==========================================
+ Hits 830 835 +5
+ Misses 99 94 -5 ☔ View full report in Codecov by Sentry. |
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.
Final small comments.
docs/conf.py
Outdated
@@ -57,9 +58,13 @@ | |||
# Add any paths that contain custom static files (such as style sheets) here, | |||
# relative to this directory. They are copied after the builtin static files, | |||
# so a file named "default.css" will overwrite the builtin "default.css". | |||
html_static_path = ["_static"] | |||
# html_static_path = ["_static"] |
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.
question: Does this need to be commented?
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.
AFIK this was originally left as a commented out piece of code in the conf.py template, but I'll go ahead and remove it.
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.
It's currently not commented on main
, so unless the change is required, I think we can leave it as-is. So rather than remove it, put it back in there and not commented.
I implemented automatic documentation generation for the casanovo CLI using the sphinx-click package. This does introduce a new dependency on the sphinx-click python package in order to build the documentation.