readme.md and index.md additions