docs request: describe how multiple writers interact in a document

[b5]

Great question from the IPFS Discord:

What about multiple writers? How a conflict is resolved when multiple users trying to update a value under the same key in a shared document? Does last write wins or how it works?

Last write wins is exactly correct. What isn't totally obvious is documents are really a kind of "multiverse", where all entries in the namespace are prefixed with the author pubic key & write timestamp. Each writer keeps the latest of all of their entries. You can filter a document keyspace using the author argument.

Steps to fix:

[ ] add a "conflict resolution" section to the documents layer that expands & completes the above description
[ ] make a new diagram showing the "multiverse"
[ ] describe some common scenarios, outcomes, and downsides