DOC: Add description for blank lines after the docstring.

[bingyao]

This is mainly a discussion, I notice that there is a blank line between the closing quotes and the pass:

...
"""

pass

But from the PEP 257, it seems that there are no blank lines after the function docstring (no specific statement, but the examples in it don't contain the blank line). And the blank line separation only requires for class docstring:

Insert a blank line after all docstrings (one-line or multi-line) that document a class -- generally speaking, the class's methods are separated from each other by a single blank line, and the docstring needs to be offset from the first method by a blank line. (source)

So I am wondering: should we specifically suggest no the blank line after the functions/methods docstring OR it just doesn't matter and people can choose whatever they like?

[larsoner]

People can choose whatever they like, but no problem from my end to promote the standard. So +1 for merge from me

[jnothman]

Thanks @bingyao, I agree the example was not doing the right thing.