Gwen had a really good blog post on confusing things about Kafka: http://ingest.tips/2015/03/26/what-is-confusing-about-kafka/
A lot of these are in-flight now (e.g. consumer) or finished (e.g. delete topic, kind of, and non-sticky producer partitioning). Do we have bugs for the rest? It would be great to make this an ongoing thing we do to assess confusing configs, etc. Not sure the best way, to do this, but maybe just maintaining a special JIRA tag and periodically polling people again? -Jay