add some dev notes to docs