README updates

Also minor markup changes.