more comments added

added more explanatory comments/ documentation