I'll do as you ask, but this one made me laugh. I had exactly the same discussion with my team. I was also in the "on one line" camp, and pointed to the examples in PEP8, but I was voted against unanimously. (And it turns out line breaks and leading spaces are stripped from the start of the docstring.) The rest of the team said they found it more readable if the docstring started on a new line. I conceded and converted.