Documentation, reformat and small refactor

- renamed Zookeeper and consumeTopic()
--- to Kafkazoo and consume()
--- but kept references for backward compatibility
- removed global vars
- extracted zookeeper interactions to a central method
- reformatted to make all indents equal
- corrected examples re changed logging
- renamed variables to more descriptive names