Improve the documentation
Issue #4
new
- Document the Karma preprocessor
- Add better examples for common use cases
- Document the shape of the files returned when the promise is resolved