update README and notes.