dev: improve codebase documentation

[Khabib73]

I'm currently learning the codebase, and I've noticed that many functions and classes lack documentation. I'd like to add it.
Could you please assign this issue to me :)

[vgvoleg]

ok sure, please mention the list of changes you are planning to do