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

api: docstring updates (2) #3426

Merged
merged 13 commits into from
Mar 11, 2020
Merged

api: docstring updates (2) #3426

merged 13 commits into from
Mar 11, 2020

Conversation

jorgeorpinel
Copy link
Contributor

@jorgeorpinel jorgeorpinel commented Mar 2, 2020

Continues #3352
to match iterative/dvc.org/pull/908

Closes #3092

  • ❗ Have you followed the guidelines in the Contributing to DVC list?

  • πŸ“– Check this box if this PR does not require documentation updates, or if it does and you have created a separate PR in dvc.org with such updates (or at least opened an issue about it in that repo). Please link below to your PR (or issue) in the dvc.org repo.

  • ❌ Have you checked DeepSource, CodeClimate, and other sanity checks below? We consider their findings recommendatory and don't expect everything to be addressed. Please review them carefully and fix those that actually improve code or fix bugs.

Thank you for the contribution - we'll try to review it as soon as possible. πŸ™

dvc/api.py Outdated Show resolved Hide resolved
dvc/api.py Show resolved Hide resolved
dvc/api.py Outdated Show resolved Hide resolved
dvc/api.py Outdated Show resolved Hide resolved
@jorgeorpinel jorgeorpinel requested review from Suor and shcheklein March 3, 2020 07:47
Copy link
Contributor

@Suor Suor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only .open() left, wrote a comment. Otherwise it's ready to merge, thanks @jorgeorpinel.

Copy link
Contributor

@Suor Suor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @jorgeorpinel, reads smooth now to me.

@efiop efiop requested a review from skshetry March 10, 2020 09:07
@efiop efiop merged commit 9944efb into iterative:master Mar 11, 2020
efiop added a commit that referenced this pull request Oct 12, 2020
* api: update to latest definitions to match iterative/dvc.org/pull/908

* Update dvc/api.py

* metrics show: update -h output to match docs
per iterative/dvc.org@2c34521

* api: update docstrings to match iterative/dvc.org/pull/908

* api: refactor DVC repo check in get_url, and document it

* dvc: cosmetic edits as I explored exceptions that api functions may raise

* api: copy default info to read() docstring from open()
per #3426 (review)

* api: improve open() docstring for clarity and add example
per #3426 (review)

* api: remove unnecessary info from get_url docstring
per #3426 (comment)

* api: produces->generated in open() docstring

* api: simplify open docstring
per #3426 (comment)

* term: "metrics" plural in output messages
iterative/dvc.org#1848 (review)

* typo

Co-authored-by: Ruslan Kuprieiev <[email protected]>
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.

api: inline documentation (docstrings)
5 participants