Nitpick: if you want Sphinx to be able to pick up function parameter documentation, you need to have a blank line between your function documentation and your parameter documentation. Like this:
```python
"""
this is my function doc

:param foo: this is the foo param
:param bar: this is the bar param
"""
```