I would suggest instead of inline comments write block comments, describing the behavior of a function or reasonably big and not straightforward section of code

I would suggest instead of inline comments write block comments, describing the behavior of a function or reasonably big and not straightforward section of code. Basically documenting what is not obvious just reading it without context.