nickva commented on a change in pull request #216: Re-write the bulk doc transaction description to reflect a single mode URL: https://github.com/apache/couchdb-documentation/pull/216#discussion_r154214198
########## File path: src/api/database/bulk-api.rst ########## @@ -418,24 +418,16 @@ in bulk must be handled separately; see :ref:`api/db/bulk_docs/validation`. Bulk Documents Transaction Semantics ==================================== -CouchDB supports two different modes for updating (or inserting) -documents using the bulk documentation system. Each mode affects both -the state of the documents in the event of system failure, and the level -of conflict checking performed on each document. The two modes are: - -- **non-atomic** - - The default mode is `non-atomic`, that is, CouchDB will only guarantee - that some of the documents will be saved when you send the request. - The response will contain the list of documents successfully inserted - or updated during the process. In the event of a crash, some of the - documents may have been successfully saved, and some will have been - lost. +Bulk document operations are **non-atomic**. This means that CouchDB does not +guarantee that documents included in a bulk update (or insert), will be saved Review comment: That's sounds good. I was thinking how to highlight that `non-atomic` means there are no guarantees regarding the group of documents being updated together. Say if the user has two documents: <doc1> and <doc2> and they have to somehow be kept in sync (that is updated together). They might think `_bulk_docs` with `[<doc1>, <doc2>]` would do that, but it turns out <doc1> might be updated and a client would read the database at just the right time to only see the update to <doc1> but not <doc2>. Otherwise, any individual document has the same guarantees as the if the document would be updated via the <db>/<doc_id> endpoint. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services
