readme changes and small linting fixes