-
Notifications
You must be signed in to change notification settings - Fork 25.9k
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
Quality explain #14264
Quality explain #14264
Conversation
53b57d1
to
a46ed5d
Compare
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 fantastic, Sylvain. Thank you for adding this important guide.
I'd only suggest to rename the doc to pr_checks
(tests already has a different meaning, so it'd be misleading).
Also left a few suggestions to the wording.
Co-authored-by: Stas Bekman <stas00@users.noreply.github.com>
Thanks for the extended review @stas00 ! Will rename the page. |
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.
Very nice, thank you for taking care of that @sgugger!
* Start PR doc * Cleanup the quality checks and document them * Add reference in the contributing guide * Apply suggestions from code review Co-authored-by: Stas Bekman <stas00@users.noreply.github.com> * Rename file as per review suggestion Co-authored-by: Stas Bekman <stas00@users.noreply.github.com>
What does this PR do?
This PR reorganizes the quality checks by splitting the current
make quality
in two:make quality
is the check on code stylemake repo-consistency
contains all other general checks on the repoSimilarly in the CI checks, the old
check_repository_consistency
check (that tested links used in the library are on S3 back in the pre-git repo days) performs the checks ofmake repo-consistency
, whilecheck-code-quality
only focuses on the code quality.In practice, nothing changes for the users of
make fixup
, but users ofmake quality
have to remember two different lines:make quality
andmake repo-consistency
.I also have drafted a doc page explaining all those changes and what each check does (for advanced contributors as well as team members), with TODOs of checks I plan to add in the future.
One last future plan I also have is to make the
make repo-consistency
command perform all checks and report all failures at the end (instead of stopping at the first one).