Not to nitpick about dots, but as a preference I *don't* use them in places like this since it's not actually a proper sentence.

But if we've decided to make the first line of every docstring a "sentence" regardless I'm okay with it for consistency's sake.