-fix formatting, add a few notes