adding some comments

line by line trying to figure this out, added a question for matt