Updates documentation and provides better instrumentation

Better logging to help debug issues and improves documentation

This should help out with the issues related to #6 

Please review @releod @costford 

/cc @markdunkley since I updated them docs and such