changes as suggested in the pull request
added several documentation lines
remove unnecessary comments
corrected spacing