Javadoc improvements

Hi @olivergierke, while reading through the codebase I polished some javadocs along the way. Would it be okay to merge this without the overhead of a JIRA (hoping that that's less work for you)?

ICLA# 32120120730115144