◐ Shell
clean mode source ↗

Message 113059 - Python tracker

>> Docstrings should be written in the standard PEP-8 way (single line
>> summary + additional explanation as needed following a blank line).
> Corrected where applicable. Is it OK if the one-sentence summary is
> occasionally longer than one line?

It’s a one-line summary, not one sentence. PEP 257 has all the details you’re looking for, and more.