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

chore(doc): Add Sphinx build #77

Merged
merged 11 commits into from
Apr 17, 2024
Merged

Conversation

KyleFromNVIDIA
Copy link
Contributor

No description provided.

Copy link
Contributor

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

Copy link
Contributor

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

docs/source/_templates/class.rst Show resolved Hide resolved
docs/source/_templates/module.rst Outdated Show resolved Hide resolved
docs/Makefile Outdated Show resolved Hide resolved
docs/source/conf.py Outdated Show resolved Hide resolved
pyproject.toml Outdated Show resolved Hide resolved
Copy link
Contributor

@vyasr vyasr left a 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!

@KyleFromNVIDIA KyleFromNVIDIA merged commit f692b70 into rapidsai:main Apr 17, 2024
4 checks passed
@GPUtester
Copy link

🎉 This PR is included in version 1.13.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants