Edited comments

Comments are edited to make API more reader friendly. Edited to show
what it does instead of how it does it