added notes about the refactor and some typo fixes.