documentation and readme.md are updated