updated CHANGELOG with a quick overview of changes
API docs generation plus a bit of refactoring

- modified a few error messages to be more helpful
- added Sami and config to be able to generate API docs
- modified example environaut.json.dist
- bin-dir of composer is now back to the default vendor/bin folder