Use Javadocs rather than source code links when possible

See https://trello.com/c/u96Pr1vO/91-bio-formats-general-doc-improvements

--no-rebase
Do we really want to get into defining detailed 'short-cuts' like this? By the time you've typed the first bit, you may as well just use the existing `:javadoc:` formatting instead really.