add a few more notes to the readme and clarify some things