-
-
Notifications
You must be signed in to change notification settings - Fork 164
Description
If I understand correctly, and from my testing, then...
https://www.rethinkdb.com/api/javascript/append/
...does nothing to manipulate the database at all.
This behaviour should be made explicit, as it is only implicitly demonstrated e.g. in the https://www.rethinkdb.com/api/javascript/update/ example, where the result of append has to be reassigned to the member field, but the dissociation between e.g. r.table("users")("arrayChild") and the backing database when using Array manipulation is not really stated in the documentation.
Does r.table("users")("arrayChild") sometimes map to the backing data structure, (e.g. it can sometimes be used to make changes in the database) and sometimes not? Alternatively is it always 'read only' until it is used as part of a merge specification to update().
Good to get this stated, and if there's a central place where it's stated there could be links from the pages of the relevant operations (e.g. append, insertAt etc)