[go: up one dir, main page]

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

checkstyle: remove VariableDeclarationUsageDistance suppression #875

Open
elefeint opened this issue Jan 11, 2022 · 4 comments
Open

checkstyle: remove VariableDeclarationUsageDistance suppression #875

elefeint opened this issue Jan 11, 2022 · 4 comments

Comments

@elefeint
Copy link
Contributor
  1. Remove <suppress checks="VariableDeclarationUsageDistance" files=".*"/> from checkstyle-suppressions.xml.
  2. Write javadoc to address as many issues as you want to handle at a time.
  3. Put the suppression back if any violations remain.
  4. Send PR.
    Rinse, repeat until all missing javadoc is written.
@Jasleen-Kaur-h20210054
Copy link

I'm interested in contributing to this issue. Can I do that? Also before I start working it, would you mind sparing your time explaining what the fix will be like and pointing me to some resources to get started.

@elefeint
Copy link
Contributor Author
elefeint commented Sep 8, 2022

You can work on the issue, but since the issue description is a list of exactly what needs to be done -- what additional information were you looking for?

@elefeint
Copy link
Contributor Author
elefeint commented Sep 8, 2022

Okay, I'll give this a try -- checkstyle is a set of validations that ensure code quality on a project. In case with this project, the codebase switched from Spring style to Google style a couple of years ago. As a result of that, we left some code quality technical debt in the form of these disabled checkstyle rules.

The first thing you'd want to do is check out the project source code -- git checkout git@github.com:GoogleCloudPlatform/spring-cloud-gcp.git (that will require you to set up certificate authentication per github docs. You may choose any other authentication method, but the checkout command will change slightly).

Once checked out, you'd want switch into the project's directory, and build it to make sure everything works correctly on your machine -- mvn clean install. Note that you will need Maven and Java installed locally for this to work.

Once that is done, you can start looking into the task. Like the description says, remove <suppress checks="VariableDeclarationUsageDistance" files=".*"/> from checkstyle-suppressions.xml file. Then try running mvn validate, and seeing the results. Your goal is to iteratively fix the checkstyle failures.

@Jasleen-Kaur-h20210054
Copy link
Jasleen-Kaur-h20210054 commented Sep 8, 2022 via email

Jasleen-Kaur-h20210054 added a commit to Jasleen-Kaur-h20210054/spring-cloud-gcp that referenced this issue Dec 11, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants