Added some more detail to comments

some things were a little bit vague