Change the comments to be more detailed.

neobrain left a comment on the last PR that didn't get addressed.