KAFKA-1328 follow up: Updated javadoc