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

Sdev/javadocs #2674

Open
wants to merge 16 commits into
base: 1.20.1
Choose a base branch
from
Open

Sdev/javadocs #2674

wants to merge 16 commits into from

Conversation

stanieldev
Copy link
Member

What

This PR adds a bunch of JavaDocs for functions that previously didn't have them, were unclear, or were outdated.

Implementation Details

When reviewing, I would look for my descriptions being proper, since some of them I had to figure out after reading the function's contents multiple times.

Outcome

Hopefully the readability will increase and help with future development.

Potential Compatibility Issues

I didn't change any variable names, instead leaving them as TODOs while I was working.
They can be removed in the future when they are either changed or rejected.

It's bad form and I'm eepy so I did this earlier
Remove some @see's
Use InheritDoc instead of @see
Remove @implNote at the beginning of the function description
This took so long I'm dying
These are getting harder 😭
All I'm going for now. A lot of the docs are copy-paste
@stanieldev stanieldev added Documentation Improvements or additions to documentation 1.20 Do Not Merge DO NOT MERGE THIS PR YET! labels Dec 30, 2024
@stanieldev stanieldev requested a review from a team as a code owner December 30, 2024 18:55
Copy link
Member

@Ghostipedia Ghostipedia left a comment

Choose a reason for hiding this comment

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

Looks Good, just run formatting and we can merge it 👍

@@ -71,7 +70,7 @@ public static BlockColor tintedColor() {
return pipe.getFrameMaterial().getMaterialSecondaryRGB();
}
}
if (pipe.isPainted()) {
else if (pipe.isPainted()) {
Copy link
Member

Choose a reason for hiding this comment

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

this shouldn't be an else if, it should fall through to this if the frame material checks fail IMO.

Copy link
Member

Choose a reason for hiding this comment

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

also, spotless.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
1.20 Do Not Merge DO NOT MERGE THIS PR YET! Documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants