second round of feedback

I've reviewed the text and added a bunch of comments, etc.