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

Overhaul Javadoc of RetryTemplateBuilder #359

Merged
merged 3 commits into from
Jun 7, 2023

Conversation

aahlenst
Copy link
Contributor

@aahlenst aahlenst commented Jun 6, 2023

While working on RetryTemplateBuilder, I noticed a couple of typos, some confusing explanations, a lack of descriptions of error conditions, and that it does not always follow the Spring Framework style guide. So I tried my best to improve it.

If you're not happy with some choices I made, feel free to edit it yourself.

Copy link
Member

@artembilan artembilan left a comment

Choose a reason for hiding this comment

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

Just great!

Please, update the Copyright of the affected classes to the current year and add your name to the @author list.

Thanks

@@ -497,10 +506,11 @@ public RetryTemplateBuilder withListener(RetryListener listener) {
}

/**
* Appends all provided {@code listeners} to {@link RetryTemplate}'s listener list.
* Appends all provided {@code listeners} to {@link RetryTemplate}'s list of
Copy link
Member

Choose a reason for hiding this comment

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

The method Javadoc must be imperative: https://github.com/spring-projects/spring-framework/wiki/Code-Style#javadoc-formatting

I see that in some place you have it fixed, but not here.

@aahlenst
Copy link
Contributor Author

aahlenst commented Jun 7, 2023

Problems should be fixed. As far as I can see, I'm already mentioned as an@author on all the classes.

@artembilan artembilan added this to the 2.0.2 milestone Jun 7, 2023
@artembilan artembilan merged commit 1c7fab8 into spring-projects:main Jun 7, 2023
2 checks passed
@artembilan
Copy link
Member

@aahlenst ,

thank you for contribution; looking forward for more!

@xak2000
Copy link
Contributor

xak2000 commented Jun 21, 2023

Small correction. This task is not about RestTemplateBuilder as stated in the title, but about RetryTemplateBuilder. :)

Noticed "Overhaul Javadoc of RestTemplateBuilder" in v2.0.2 release notes and was very surprised. 😄

@artembilan artembilan changed the title Overhaul Javadoc of RestTemplateBuilder Overhaul Javadoc of RetryTemplateBuilder Jun 21, 2023
@artembilan
Copy link
Member

Fixed.
Thank you! 😄

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

Successfully merging this pull request may close these issues.

None yet

3 participants