First round of adding some useful comments

I'm making an effort to write (useful) comments to parts of my
code where the idea/intent/execution might not be clear. This is
the first of a couple of commits where I go back and fill in any
gaps that I see.