further edits plus the README file