I'm using the standards written [here](http://blog.joda.org/2012/11/javadoc-coding-standards.html) for Javadoc'ing the api. There's an issue open for clear docs for the public apis in the library so the whole interface + javadocs hopes to work against that issue.

Novoda's checkstyles mainly lets you use the standards listed (which mainly adhere to Oracle's standards), except these standards prefer `<p>` to `<p/>` claiming there's no need for valid XHTML (which our checkstyles disagrees with), and when writing the parameters, return args and throws references, the standards promote double space after var name, e.g.:

    @param myParam  the param that is mine

which our checkstyles replaces for 

    @param myParam the param that is mine