small enhancements to readme and index file