add some notes to /docs