Improve documentation

- include 'Why?' section to explain what the hell this is
- fix `options.base` example