RE: https://mastodon.social/@APIdia/115644204111693537

There is a JEP pending to bring admonitions to Javadoc!
https://openjdk.org/jeps/8363700
(They call it "notes" though, but it's effectively the admonition concept as known from tools like Sphinx or AsciiDoc.)
APIdia found its own solution for admonitions in Javadoc some years earlier:

#java #javadoc #apidia #jvm