[0.2.2] Documentation update

[0xaa55h]

Add more documentation for the methods consumers are interacting with, again this would help everyone to understand how everything works