readme.md and other optimizations