adds README.md; adds more comments; adds more config