readme.adoc revision:
- changed ending punctuation
- changed order of titles in blocks according to asciidoc syntax
reference
- some typos