improved the README and use the asciidoc syntax