New javadoc annotation @apiNote

I would say they are now "official" if not standard. See JDK-8068562. As Nicolai pointed out above, his blog post New Javadoc Tags @apiNote, @implSpec and @implNote gives a great overview. They are supported by Netbeans, supported by IntelliJ, and supported by Eclipse. They are discussed and recommended in Effective Java, Third Edition. They are used throughout the core Java library source code.


From the mailing list item quoted by @bargenson:

These tags are enabled by use of the -tag feature on the javadoc tool command line. They are not proposed as standard javadoc tags and may be implemented differently in future Java releases. Since they are implemented as custom tags just for the JDK API documentation you can't automatically use them in your own code. (You can, of course, add the same command line options to your javadoc invocations if you like these tags).

So they aren't standard Javadoc tags at all.