Code Comments for KDoc (equivalent of Java's JavaDoc)

[jumaallan]

Code readability.
As the code base grows, we need to make sure its properly documented so as to make it easy for users to understand what the code does, args needs, what it returns and why

Solution
Make sure all methods are properly commented, to make documentation easy.

Additional context
We might need to have a CI which performs this check, not sure. Open to ideas

[jumaallan]

https://kotlinlang.org/docs/reference/kotlin-doc.html