Enhance docs based on Javadocs?

I see people ask a lot of questions here about how to do this or that with `kafka-python`.
Not so long ago I released `aiokafka=0.3.0` with an updated [consumer](http://aiokafka.readthedocs.io/en/stable/consumer.html) and [producer](http://aiokafka.readthedocs.io/en/stable/producer.html) documentation. It contains some useful (in my opinion) code snippets, mostly based on Consumer Javadoc. Maybe I could change it to respect `kafka-python`'s way of doing things and people would find more useful information there.

@jeffwidman @dpkp