DOC: Write CQL cheat sheet
Summary
The query language is very simple, but its documentation is hard to read. A visual representation (one A4 page) of the possibilities would be very useful for new users.
Expected Behavior
CQL should be intuitive to use for people with basic programming understanding.
Actual Behavior
People are confused by syntactic sugar, and they do not know which parts can be omitted and which cannot. The query language has more keywords that it seems at the beginning.
Steps to Reproduce the Problem
- Try to run a course of students through a pycaosdb tutorial without a lengthy (20-30 minutes) CQL introduction.
Specifications
- Version: Current demo server.
- Platform: Any.
Possible fixes
- Write a cheat sheet with the main elements of CQL, enough to do most tutorials.
- The cheat sheet should have graphical elements to easily find commands which relate to dates, references, etc.