Lotsa javadoc improvements
* diagrams for previously-undiagram'd methods
* links to wiki docs where available
* standardizing format & nomenclature
Merge pull request #709 from Netflix/docs

Lotsa javadoc improvements