Readme reworked

Use reStructuredText for README, structure the documenation and get
TOC for easier navigation. With this approach, the wiki should not be
needed at all, having all info in one repo.

You can see how it looks like here: https://github.com/iNecas/apipie-rails/blob/readme-rework/README.rst