Skip to content

api: docstring updates (2)#3426

Merged
efiop merged 13 commits into
treeverse:masterfrom
jorgeorpinel:api
Mar 11, 2020
Merged

api: docstring updates (2)#3426
efiop merged 13 commits into
treeverse:masterfrom
jorgeorpinel:api

Conversation

@jorgeorpinel
Copy link
Copy Markdown
Contributor

@jorgeorpinel jorgeorpinel commented Mar 2, 2020

Continues #3352
to match treeverse/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. 🙏

Comment thread dvc/api.py Outdated
Comment thread dvc/api.py
Comment thread dvc/api.py Outdated
Comment thread dvc/api.py Outdated
@jorgeorpinel jorgeorpinel requested review from Suor and shcheklein March 3, 2020 07:47
Copy link
Copy Markdown
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
Copy Markdown
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 treeverse:master Mar 11, 2020
efiop added a commit that referenced this pull request Oct 12, 2020
* api: update to latest definitions to match treeverse/dvc.org/pull/908

* Update dvc/api.py

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

* api: update docstrings to match treeverse/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
treeverse/dvc.org#1848 (review)

* typo

Co-authored-by: Ruslan Kuprieiev <kupruser@gmail.com>
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