Improve documentation - recommend more useful default configuration

- add installation instructions
- mention sourcemaps
- separate optional options from the recommended configuration
- update the example tests to use the new defaults in example dir
Fixes issue that keeps karma from exiting

Added support to explicitly stop the server and middleware when karma wants to exit. Fixes #18
documentation
bug fixes
Merge branch 'pr-25'
updated deps
1.3.0