Improve documentation

[mr-git]

It is not very clear on how to use each kind of Producers or what are the benefits of skafa project over default kafka-clients

[BBartosz]

Same question here. Looks promising but not sure its production ready etc.

[t3hnar]

@BBartosz agree, there is lack of documentation. We will address this.

Jumping ahead - it is productions ready :)