-
Notifications
You must be signed in to change notification settings - Fork 565
[MLDM-66] Package documentation #10360
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
Conversation
size-limit report 📦
|
…ckage-documentation
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## master #10360 +/- ##
==========================================
+ Coverage 62.17% 62.20% +0.02%
==========================================
Files 1219 1219
Lines 87664 87663 -1
Branches 1820 1820
==========================================
+ Hits 54507 54532 +25
+ Misses 32316 32292 -24
+ Partials 841 839 -2
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Sentry. |
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.
Looks good to me. This will be great to enforce going forward!
// Package client implements a gRPC client for Pachyderm. | ||
// | ||
// Before using this package, give serious thought to just using the generated | ||
// gRPC interface directly. |
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.
👍
This adds a check for the presence of package documentation, and adds minimal documentation throughout.
In the interest of time, in most cases that documentation is little more than “Package foo needs to be documented,” but I did try to come up with something slightly better when I could.