I think @enchantner dislike how you format parameters. [From here](http://www.python.org/dev/peps/pep-0287/#docstring-significant-features)
```
Field lists represent a mapping from field name to field body. These are mostly used for extension syntax, such as "bibliographic field lists" (representing document metadata such as author, date, and version) and extension attributes for directives (see below). They may be used to implement methodologies (docstring semantics), such as identifying parameters, exceptions raised, etc.; such usage is beyond the scope of this PEP.
```
There is no standard for parameters. We can agree to use [sphinx's format](http://sphinx-doc.org/domains.html?highlight=parameters#info-field-lists) for parameters describing.
Example from openstack
```
    :param context: context to query under
    :param session: if present, the session to use
    :param read_deleted: if present, overrides context's read_deleted field.
```