initial commit of my self notes on the state of my code

includes a running list of limitations and hacks