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

Extract display name and description from JavaDoc #51

Merged
merged 7 commits into from
Dec 17, 2023

Conversation

timtebeek
Copy link
Contributor

@timtebeek timtebeek self-assigned this Dec 17, 2023
Copy link
Contributor

@Stephan202 Stephan202 left a comment

Choose a reason for hiding this comment

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

Nice! Within Error Prone Support we currently have similar functionality using an @Description annotation, but I have pondered in the past whether indeed we should instead just look at the Javadoc. So this change SGTM!

@timtebeek
Copy link
Contributor Author

Nice! Within Error Prone Support we currently have similar functionality using an @Description annotation, but I have pondered in the past whether indeed we should instead just look at the Javadoc. So this change SGTM!

Ah interesting! Had been looking for something like that on your end, but didn't immediately spot anything. I only see that @tech.picnic.errorprone.refaster.annotation.Description applied twice though, once in tests. I'm guessing you're considering just taking the JavaDoc there as well then?

@timtebeek timtebeek merged commit 626b74f into main Dec 17, 2023
1 check passed
@timtebeek timtebeek deleted the extract-display-name-and-description-from-docs branch December 17, 2023 21:21
@Stephan202
Copy link
Contributor

I'm guessing you're considering just taking the JavaDoc there as well then?

Nothing decided, but at this point it seems likely: the JavaDoc seems more maintainable and easy to use, especially when considering line wrapping.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

2 participants