Update KafkaTopology example and the example documentation

This commit updates the provided example KafkaTopology to make it function with kafka_2.9.2-8.1.1 and recent developments in Storm-Kafka integration.

It also updates the example documentation, and moves it to the ``examples`` directory. There is now a link to the example documentation in the main ``README.md``.