added to the comments and doc strings

yeah, just making it easier to read