It would be nice if people's API javadocs were well-formed.
Update internal documentation.