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

CLI documentation page generation #342

Merged
merged 22 commits into from
Jul 9, 2024
Merged

CLI documentation page generation #342

merged 22 commits into from
Jul 9, 2024

Conversation

Lilferrit
Copy link
Contributor

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.

@wsnoble wsnoble requested a review from wfondrie June 25, 2024 16:32
@bittremieux bittremieux linked an issue Jun 26, 2024 that may be closed by this pull request
Copy link
Collaborator

@bittremieux bittremieux left a 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.

docs/cli.rst Outdated Show resolved Hide resolved
docs/cli.rst Outdated Show resolved Hide resolved
docs/_static/js/cli-page.js Outdated Show resolved Hide resolved
docs/images/configure-help.svg Outdated Show resolved Hide resolved
Copy link

codecov bot commented Jul 8, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 89.88%. Comparing base (7372eb0) to head (0cbfef6).

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.
📢 Have feedback on the report? Share it here.

Copy link
Collaborator

@bittremieux bittremieux left a 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 Show resolved Hide resolved
docs/conf.py Outdated Show resolved Hide resolved
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"]
Copy link
Collaborator

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?

Copy link
Contributor Author

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.

Copy link
Collaborator

@bittremieux bittremieux Jul 9, 2024

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.

docs/sphinx_click_handlers.py Outdated Show resolved Hide resolved
@Lilferrit Lilferrit merged commit fcece1b into dev Jul 9, 2024
7 checks passed
@Lilferrit Lilferrit deleted the man-pages branch July 9, 2024 23:55
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.

Add "man pages" for casanovo commands
2 participants