clean up comments, move block comment to new README.md