KAFKA-1522; Follow-up patch (added some documentation comments); reviewed by Joel Koshy