Added comments and notes from DJ on the latest edit

DJ reviewed the text and suggested edits. This diff takes care of those
edits