RF: docstring rewrite; a PEP8 fix

Suggested by Eric L from PR review.