resolves #1127 add key documentation links to README

- also adds them to asciidoctor.org home page