Docs: fix all docstrings

Here is the consiberable improvment of API documentation: fix indentation, methods description, types etc

The idea is that we have all docstrings unified, so it will be easier to read the documentation and maintain it