README update

Update the README:

* Improve the overall readability (by using syntax highlighting, tables e.d.)
* Add additional documentation for the query methods
* Add missing documentation for the configuration