formatting of README.md and fixed paragraph handling in commentator