not sure if we ever went through it and/or if it is in PEP8

but it is good to have function docstrings as 

```
"""Brief sentences summary of the function.

Longer description
possibly in multiple lines/paragraphs
"""
```

to stay consistent, and to provide quick documentation in first line on what it is about