Improve documentation and defaults for consumer configuration

Based on practical experience by @manygrams 

Also @wvanbergen @fw42 for review please.

Related question: do we want to bump the default fetch size? I think my original reasoning for 1024 was that it was under the ethernet MTU, but that's a poor reason (TCP fragmentation is much faster than a full round-trip per message).