<!DOCTYPE html><html><head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<p>Re:
<a class="moz-txt-link-freetext" href="https://mail.openjdk.org/pipermail/core-libs-dev/2024-September/129508.html">https://mail.openjdk.org/pipermail/core-libs-dev/2024-September/129508.html</a><br>
This is a thread on using increasing the use of `{@return}`</p>
<p>In it, Pavel wrote:<br>
</p>
<pre style="white-space: pre-wrap; caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration: none;"><blockquote type="cite"><pre style="white-space: pre-wrap; caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration: none;">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.</pre></blockquote></pre>
<p><br>
</p>
<p>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).</p>
<p>-- Jon<br>
</p>
</body>
</html>