Use proper docstring everywhere in english as this package use complex logic, and it is hard to understand for an external user or for you in the future.
I use a lot of code definition inspector and good docstring helps a lot and it is for me more important than comments
e.g.

