KAFKA-3598: Improve JavaDoc of public API#1250

mjsax wants to merge 3 commits into

apache:trunkapache/kafka:trunkfrom

mjsax:JavaDoc-publicAPImjsax/kafka:JavaDoc-publicAPICopy head branch name to clipboard