-
Notifications
You must be signed in to change notification settings - Fork 14
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
chore(doc): Add Sphinx build #77
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.
Please use NumPy style docstrings for consistency with most of RAPIDS.
src/rapids_dependency_file_generator/rapids_dependency_file_generator.py
Outdated
Show resolved
Hide resolved
0aa8a88
to
53380ad
Compare
53380ad
to
d48b399
Compare
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.
We don't have to do it in this PR, but once this is merged can we replace all the current linters possible with ruff? When we do, we can also enable ruff's rules for docstring linting to help ensure that these docstrings stay in good shape (complementary to building with warnings as errors as I suggested in an inline comment). It might be worth trying to just add ruff in this PR for the purpose of docstring linting and seeing how extensive the changes are, in case they're not too bad.
Most of the changes that I suggested are optional, but it's worth trying them out before we merge in case they're easy and we can just knock them out here.
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.
Approved, assuming you add the remaining ruff rules we need. Thanks!
🎉 This PR is included in version 1.13.1 🎉 The release is available on: Your semantic-release bot 📦🚀 |
No description provided.