Update some RST documentation syntax#2463

dpkp merged 3 commits intomasterdpkp/kafka-python:masterfrom

HalfSweet-masterdpkp/kafka-python:HalfSweet-masterCopy head branch name to clipboard