Overall this looks good to me!

I'd rename the "Setup and how to use" to "Setup and deployment models", to make it clear that ethql can be deployed in an number of ways (standalone, embedded, hosted on Infura).

"How to contribute" is super valuable.

An architecture/design section would be welcome (this one is on me!).

@akhila-raju could you break this down into a task list so we can track progress individually?

Would be great if you could start working on it ASAP.

For the contribution guide, you can take inspiration from popular Github repos. Have a look at "projects with the most contributors" and "most-forked projects" here: https://octoverse.github.com/.

Another valuable source is Apache projects (Apache Ignite has a well-structured process).

Here's another one: https://gist.github.com/PurpleBooth/b24679402957c63ec426

Sure, I'll add a task list. Already started working on it 😊

Query handbook is done, unless there are more that should be added! 😊