Better integration with readthedocs

 * architecture.asciidoc => architecture.md
 * Added doc/README.md
I'd add something like `Moreover the long term plan is to get rid of all other languages (wherever possible) and use Ruby as the only language.` so it's clear that Ruby is the right choice.