Use Javadocs rather than source code links when possible

See https://trello.com/c/u96Pr1vO/91-bio-formats-general-doc-improvements

--no-rebase