improved documentation and readme.md