Updated the read me

+ I ran the html version of the read me through
http://domchristie.github.io/to-markdown/ to get rough markdown, which
I then cleaned up.
+ added code snippets and filled out the visibility comparison section