fix typos and add comments for graham