Moved from GitHub dgraph/4688
Posted by kesor:
The documentation for queries, mutations, schema and such are explained using different notations each time - making it very confusing to understand and hard to search for solutions amongst this confusion.
It would be way more beneficial to combine the examples so that each example is shown using all the different methods. Both all the different language clients, as well as RDF vs. JSON vs. GraphQL± notations.
This will also allow the documentation to be more to the point with regards to “what needs to be done”, and then much easier to understand with regards to “how to do it”.