clean up jef notes

Excerpted jef's notes and put into markdown
Merge pull request #2 from prpole/patch-1

clean up jef notes