Added comments

Wrote some thoughts / questions in code comments.  The code seemed to follow a similar structure all throughout, so I only commented on the first occurrence of each pattern that I observed.