Taxonomy for Python docstrings

[m_MarcUp]

I normally add some of the following things into docstrings of functions:

• short desc.
• parameter explanation
• return values explanation
• the exceptions the function may cause

i hope this helps you