new readme and comment fixes