:doc: minor documentation changes suggested by anett and style improvements