No documentation on KafkaProducer

[carlpulley]

Documentation exists for how to use the Scala KafkaConsumer, but no documentation exists for how and when you would expect users to utilise the KafkaProducer and its associated helper functions.

This can lead to difficult to debug issues - for example, using KafkaRecords.fromValues rather than KafkaRecords.fromValuesWithKey can lead to type related issues that cause messages to be dropped. Fortunately, these dropped messages are logged (though at a WARN logging level).