readme.md and more attempts at fixing documentation