I'm not in a position to say how the docs should look, as I haven't learned enough about cypher however an example of a particularly irritating page would be: optional match where the examples given are trivial and return null, hardly something usefu...
While it is cheap to bash documention, I'm afraid I agree with the original question, the docs / examples for learning CYPHER are pretty dire and the support for python is meak.
The examples in the guide are either very basic or partial.
As for what ...