Re: [Twisted-Python] Re: [Twisted-commits] r17664 - This was pre-UQDS code, so in making the transition I have to add lots of docs

Jonathan Lange wrote:

The standard is definitely unclear.

I don't have strong feelings about how docstrings should be formatted. However I would prefer it if we used PEP 257 formatting.

Just for the record, the multi-line docstring format """ Blah blah blah blah blah blah. """ is consistent with PEP 257's recommendations.

Also, I strongly object to using """ Blah. """ for one line docstrings.

It doesn't bother me, but """Blah.""" doesn't either, for one-liners.