The javadoc.tester.JavadocTester framework should specify its model clearly.

For example. It's not obvious that a subtest needs to be registered [JavadocTester.checking(...)] before it can be failed [JavadocTester.failed(...)]. Or that after a test has been registered it must call JavadocTester.passed(...) to succeed; not calling failed(...) won't have the same effect.

Also, consider specifying what happens when "passed" and/or "failed" are called multiple times within the context of a single subtest.