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