fixed asciidoc syntax, improved brevity of examples