<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

</head>

<body style="overflow-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;">

Hi David,

<div><br id="lineBreakAtBeginningOfMessage">

<div><br>

<blockquote type="cite">

<div>On 20.08.2025, at 01:47, david Grajales <david.1993grajales@gmail.com> wrote:</div>

<div>

<div dir="ltr">

<p>My question is:</p>

<ul>

<li>

<p>Is there any initiative to include more usage examples and concise, code-centric explanations in Javadoc?</p>

</li><li>

<p>Or, is there an alternative <em>official</em> documentation site that already follows this more example-driven approach?</p>

</li></ul>

<p><br>

</p>

</div>

</div>

</blockquote>

</div>

Note that this list is about development of the JavaDoc tool, not the content of API documentation. That is the responsibility of the individual libraries that are part of OpenJDK. </div>

<div><br>

</div>

<div>My impression is that example code in API docs has improved quite a bit over the last years, especially in new APIs, many of them using the new {@snippet} tag. But of course there’s always room for improvement. As to other documentation that is more example-driven

 you should be able to find tutorials on many APIs, but that is also outside my direct field of activity.</div>

<div><br>

</div>

<div>Hannes</div>

</body>

</html>