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

chore: Add CI check for method/constructor Javadoc quality #3907

Merged
merged 20 commits into from
May 12, 2021

Conversation

slarse
Copy link
Collaborator

@slarse slarse commented May 4, 2021

Fix #3906

This PR adds a script chore/ci-checkstyle-javadoc.sh which runs Checkstyle on the project, looking for Javadoc style problems on public methods/constructors. It counts the amount of Checkstyle errors on the current branch, and on the master branch, and fails the build if the current branch has more errors.

The quality check can be seen here: https://github.com/INRIA/spoon/pull/3907/checks#step:9:10

Here is the checkstyle rule used JavadocMethod. We're using default settings with the exception that we only check public methods/constructors (default is to check all visibilities).

@slarse slarse changed the title wip: chore: Add CI check for method/constructor Javadoc quality review: chore: Add CI check for method/constructor Javadoc quality May 5, 2021
@slarse slarse changed the title review: chore: Add CI check for method/constructor Javadoc quality wip: chore: Add CI check for method/constructor Javadoc quality May 5, 2021
@slarse slarse changed the title wip: chore: Add CI check for method/constructor Javadoc quality review: chore: Add CI check for method/constructor Javadoc quality May 6, 2021
@monperrus monperrus changed the title review: chore: Add CI check for method/constructor Javadoc quality chore: Add CI check for method/constructor Javadoc quality May 12, 2021
@monperrus monperrus merged commit 009ad17 into INRIA:master May 12, 2021
@monperrus
Copy link
Collaborator

Great infrastructure contribution! Thanks @slarse

@slarse slarse deleted the issue/3906-enforce-comment-quality branch May 12, 2021 09:17
@monperrus monperrus mentioned this pull request Aug 19, 2021
woutersmeenk pushed a commit to woutersmeenk/spoon that referenced this pull request Aug 29, 2021
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.

Enforce Javadoc comment quality
2 participants