Mc/code review

Hi Raina,

This pull request is pretty much just comments, you don't need to merge it. Take a look and let me know if you have questions on anything in particular.

-Mercedes