5 ms·
To be fair, this is an advanced article written by a computer scientist that designed the innards of the drivers for other computer scientists that want to unde
by coffeemug 13y ago
To be fair, this is an advanced article written by a computer scientist that designed the innards of the drivers for other computer scientists that want to understand how the drivers work.
Novices can do most things without having to understand any of these issues, and even very advanced users don't ever have to learn this if they don't want to.
Disclaimer: I'm one of the people responsible for designing ReQL.
- hoodoof 13y agoMaybe it needs to be more clear that there is a simple and a hard way to work with ReThinkDB, and whenever someone finds themself in the "hard way" documentation, that you provide clear instructions that this is the hard way and the documentation for the easy way is somewhere else. The assumption for the novice developer is that "here is the documentation, there's often just one way to do it, so I'd better read this and learn it". It's not clear that "this is the hard way, you should avert your eyes". Maybe try renaming "ReQL" to ThinkSimpleQuery and the other one to ThinkBigQuery. Something more self explanatory.
- coffeemug 13y agoWell, the second paragraph says the following: This post covers all aspects of lambda functions in ReQL from concept to implementation and is meant for third party driver developers and those interested in functional programming and programming language design. For a more practical guide to using ReQL please see our docs where you can find FAQs, screencasts, an API reference, as well as various tutorials and examples.