ethql icon indicating copy to clipboard operation
ethql copied to clipboard

General documentation

Open akhila-raju opened this issue 7 years ago • 4 comments

Add documentation under the Github wiki.

Documentation should include:

  • [ ] Setup and deployment models
  • [x] Query handbook (example queries)
  • [ ] How to contribute (running tests, opening issues & PRs, etc)
  • [ ] FAQ

What else should be added?

akhila-raju avatar Jul 16 '18 17:07 akhila-raju

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!).

raulk avatar Jul 17 '18 15:07 raulk

@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

raulk avatar Jul 17 '18 15:07 raulk

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

akhila-raju avatar Jul 17 '18 15:07 akhila-raju

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

akhila-raju avatar Jul 20 '18 16:07 akhila-raju