JavaDoc is our source of truth when comes to understanding in depth Java’s API, but also an inspiration on how we can document our own code.

Creating code documentation involves writing a combination of custom JavaDoc tags and HTML elements, which can be time-consuming and error-prone due to its complexity. Hence, let’s take a sneak peek at JEP 467 and how Java documentation could be easier to read and maintain thanks to including Markdown syntax in comments.

Make sure to check the show-notes.