Re:
https://mail.openjdk.org/pipermail/core-libs-dev/2024-September/129508.html
This is a thread on using increasing the use of `{@return}`
In it, Pavel wrote:
Maybe if a method's main description consisted only of `{@return}`, we could skip the
first sentence in the "Method Details" section and just output `Returns:`? Any
further discussion should happen on the javadoc-dev mailing list.
I think this is a good idea to look at. Although it does not have as
catchy an acronym, "Don't Repeat Yourself" (DRY) could be extended to
"Don't Make Me Read The Same text Twice" (DMMRTSTT).
-- Jon
