add more notes to docs