added comments, ready to submit?

I kind of want to send this into Dale for comments