Improvements on code readability (1): docstrings

[Miki Bonacci]

But also, write a developer guide with the details of the code implementation