Overhaul DocC documentation

[felixschlegel]

(To be done, when we agreed upon a public interface for this package)

Although we have DocC documentation already, it lacks some consistency and examples. Therefore, we want to do the following:

• polish our documentation
  • improve consistency
  • make this package easy to understand for someone who is not familiar with the Kafka terminology
• provide code examples