add some more notes to docs