Maybe 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" documentatio

Maybe 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.