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

Ngclient docstrings improvement #1856

Merged

Conversation

ivanayov
Copy link
Collaborator

This change unifies ngclient docstrings language, including wording and quoting. No major changes included, as docs look well-formed.

Fixes #1844

  • The code follows the Code Style Guidelines
  • [n/a] Tests have been added for the bug fix or new feature
  • [n/a] Docs have been added for the bug fix or new feature

@coveralls
Copy link

coveralls commented Feb 10, 2022

Pull Request Test Coverage Report for Build 1829566882

  • 2 of 2 (100.0%) changed or added relevant lines in 2 files are covered.
  • No unchanged relevant lines lost coverage.
  • Overall coverage remained the same at 98.347%

Totals Coverage Status
Change from base Build 1828868126: 0.0%
Covered Lines: 1121
Relevant Lines: 1137

💛 - Coveralls

Copy link
Member

@lukpueh lukpueh left a comment

Choose a reason for hiding this comment

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

Thanks a lot for the patch, @ivanayov. I left a few minor comments inline...

This change updates the docstrings library of ngclient with
unified double backtick quoting for better readability

Signed-off-by: Ivana Atanasova <iyovcheva@vmware.com>
This change updates the docstrings library of ngclient with no
article for all Args in order to be unified amongst all python-tuf
docstrings

Signed-off-by: Ivana Atanasova <iyovcheva@vmware.com>
This change unifies common wording in the docstrings library of
ngclient, like "Args" vs. "Arguments"

Signed-off-by: Ivana Atanasova <iyovcheva@vmware.com>
@ivanayov ivanayov force-pushed the ngclient_docstrings_imprv branch from d126f1a to e212b5d Compare February 11, 2022 13:28
@ivanayov
Copy link
Collaborator Author

Thank you @lukpueh ! Just pushed an update addressing your comments.

This change shortens line lengths that exceed the requiremets and
adds more clarification on methods where the short message is not
complete enough

Signed-off-by: Ivana Atanasova <iyovcheva@vmware.com>
@ivanayov ivanayov force-pushed the ngclient_docstrings_imprv branch from e212b5d to a0d3185 Compare February 11, 2022 13:34
@lukpueh
Copy link
Member

lukpueh commented Feb 14, 2022

Thanks for the quick updates, @ivanayov! Merging...

@lukpueh lukpueh merged commit 216c1eb into theupdateframework:develop Feb 14, 2022
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.

Review ngclient documentation
3 participants