code review notes

I like this a lot - sorry to be slow on writing up notes about it. I'll push some more later.