fix typos and add comments

Fix typos and add some clarification.

some of these might be excessively wordy.