Various fixes to readme
One more
Merge remote-tracking branch 'andschwa/docs'