Use python doc comments for API methods

I saw that many functions are documented like:

```python
# Documentation lorem ipsum
def function(...):
    ...
```

To follow the pythonic way, we should do

```python
def function(...):
"""Documentation lorem ipsum"""
    ...
```