a bit more verbose readme.md