clean up jef notes

Excerpted jef's notes and put into markdown