add doc and dev notes