fix the docs
some extra cleanup suggested by the linter