Copy edit docstring.
Add link from narrative doc & clarify example docstring.