replace markdown formated README with an asciidoc formated one

Note:

Because the asciidoc support in gihub's gollum engine is broken and there
is no sign that it will be fixed, we are avoiding the rendering of the
README by not using the 'asciidoc' file suffix normally used on github.