Add more comments in code to relate the flow of execution with the documentation

[bailaC]

Is your feature request related to a problem? Please describe. This is not related to any problem as such. Just wanted to have more commented code. May be, a single liner comment about what the following code will be doing.

Describe the solution you'd like I would like to have more commented code to help understand the flow of execution.