Improvements on code readability (1): docstrings

[mikibonacci]

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

Ruff and other linters.