Updates documentation and provides better instrumentation

Better logging to help debug issues and improves documentation
update readme
Merge pull request #81 from Shopify/bugfix/handle_invalid_files

Updates documentation and provides better instrumentation