docs and notes for personal perusal