Add more details for configuration

Add more details to avoid issues through made assumptions. E.g. add more examples, explain how configurations are loaded and which possible configurations the user is able to make.

References:

https://github.com/db-migrate/node-db-migrate/issues/360
##

---
Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/32050623-add-more-details-for-configuration?utm_campaign=plugin&utm_content=tracker%2F11704504&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F11704504&utm_medium=issues&utm_source=github).