Readme is now in asciidoc format!

Additionally some minor typo fixes, etc.