Draft: Refactor both README in this repository

Josef Schlehoferrequested to merge
improve-readme-api into master

I was fiddling around this project and I found that the documentation is for me confusing. I tried to improve it as much as I can and provide detailed steps how you can start. Hopefully, it will be handy for someone else, too!

Missing:

  • Postman queries

Merge request reports