Actually, sorry @sivapvarma for conflicting advice, but we only put the default values in the docstring for Cython functions, where there is no way to discover them by introspection. For Python functions, we don't specify default values, as they can be guessed independently, and putting them in the docstring increases the likelihood that the docstring and the definition will get out of sync.

@sciunto correct? Or am I missing something?

We do, however, start our docstring lines with a capital and end them with a full stop `.`. ;)