some notes and docs