Conversation

@sydneyfalk don't take this personal, but I think we see comments in different ways.

I use comments for describing things that are not obvious when you read over the code, or when there's needed complexity in the code (i.e: needed optimizations which are hard to read)

But, if I join a project where docstrings are heavily used, I try to adapt to that style.
That's usually how it goes with python. Every class/function has a docstring, as it is recommended by PEP8.
[1/2]