Add basic logging for Broker connection events.
Use a package level Logger.

By default, it is set to discard everything, but you can assign a new log.Logger instance to sarama.Logger.
Add basic logging to broker connection management.
Formatting and godoc fixes
Merge pull request #35 from Shopify/add_logger

Add basic connection logging