Better integration with readthedocs

 * architecture.asciidoc => architecture.md
 * Added doc/README.md
Well, you made it build and run in Ubuntu. Installation is next stop :wink:

In any case. This PR is only intended to do a conversion from asciidoc to md. I didn't go through the content itself.