linting and doc cleanup