-
Notifications
You must be signed in to change notification settings - Fork 94
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
Update API reference and examples in docs #561
Conversation
Codecov Report
@@ Coverage Diff @@
## branch-0.20 #561 +/- ##
===============================================
+ Coverage 61.06% 62.07% +1.00%
===============================================
Files 22 22
Lines 2571 2634 +63
===============================================
+ Hits 1570 1635 +65
+ Misses 1001 999 -2
Continue to review full report at Codecov.
|
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.
Thanks @charlesbluca for working on this, I added some comments.
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.
A few more questions:
Based on some discussions in #561, this PR removes some kwargs from `LocalCUDACluster` that may not be needed: - `processes` doesn't have any impact on its construction (other than throwing a `ValueError` if it's set false); this should be safe to remove altogether - `data` is pretty complex and it isn't commonly specified, so it can be removed from the named arguments and accessed through the `kwargs` object if it is specified Authors: - Charles Blackmon-Luca (https://github.com/charlesbluca) Approvers: - Peter Andreas Entschev (https://github.com/pentschev) URL: #562
I think this PR is at a good closing point - the API reference is updated, the installation + quickstart is fleshed out a bit more, and there are clear minimal examples of using LocalCUDACluster and
|
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.
One last question I missed:
"--dashboard-prefix", | ||
type=str, | ||
default=None, | ||
help="""Prefix for the dashboard. Can be a string (like ...) or ``None`` for no |
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.
Do we know what dashboard prefix input should look like?
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.
I'm not sure, maybe @jacobtomlinson can help with this one.
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.
LGTM, thanks @charlesbluca !
@gpucibot merge |
Adds sphinx-click to the Conda environment used by RTD, which is necessary now because of #561. Fixes doc builds, which are currently failing. Authors: - Charles Blackmon-Luca (https://github.com/charlesbluca) Approvers: - https://github.com/jakirkham - Jordan Jacobelli (https://github.com/Ethyling) URL: #578
Addresses #554; I tried to tidy up the installation/specializations/quickstart pages so that some of the more technical stuff could go into some published examples, and probably a new page discussing configuration of LocalCUDACluster /
dask-cuda-worker
.Also added
sphinx-click
to the dependencies so we can more easily document any changes todask-cuda-worker
(#560) - I would also like to get the docstrings for the CLI, LocalCUDACluster, andinitiailize()
up to date and more concise if possible.