#31, #32 and some small clarifications in readme.md