created WRITING document and updated the README
more README updates because I am on an airplane and have nothing else to do.
Merge remote-tracking branch 'upstream/master'

 merging in upstream but I was ahead of things. oh yeah i'm on a plane
merging upstream