Details
-
Bug
-
Status: Closed
-
Resolution: Fixed
-
None
-
*Location*: https://docs.couchbase.com/server/6.5/learn/data/durability.html#understanding-durability
*User-Agent*: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36
*Screen Resolution*: 1680 x 1050
-
DOC-2020-S6-Apr05
-
1
Description
"Couchbase Server supports durability for single-document writes only. "
This statement is confusing people in light of 6.5 ACID
cc/ Shivani Gupta
Attachments
Issue Links
- has to be done after
-
- Resolved
Activity
| Field | Original Value | New Value |
|---|---|---|
| Fix Version/s | Mad Hatter [ 15119 ] |
| Assignee | Amarantha Kulkarni [ amarantha.kulkarni ] | Tony Hillman [ tony.hillman ] |
| Fix Version/s | 6.5 Milestone 1 [ 16654 ] | |
| Fix Version/s | Mad Hatter [ 15119 ] |
| Component/s | concepts [ 12110 ] |
| Fix Version/s | to-be-triaged [ 16762 ] |
| Status | Open [ 1 ] | In Progress [ 3 ] |
| Sprint |
|
| Rank | Ranked lower |
| Rank | Ranked higher |
| Rank | Ranked higher |
| Story Points | 1 |
| Rank | Ranked lower |
| Rank | Ranked lower |
| Rank | Ranked higher |
| Rank | Ranked higher |
| Rank | Ranked higher |
| Rank | Ranked higher |
| Rank | Ranked lower |
This issue here is that on other pages we say that Couchbase supports "multi-document" ACID transactions (D=durability) and then on this specific page, we say that Couchbase only supports single-document durability. From the eyes of the user, that's the inconsistency (no pun intended) and in reality isn't true anymore because we do support durability for multiple documents at the same time.
The concepts of "durability" (replication and disk persistence), as well as "consistency" need to be updated throughout the docs to tie everything together.
Daniel Owen this is coming up again and again. Why do you think the current statement is accurate and advised Tony to keep it as is?
Tony Hillman Chip Owen this statement NOT correct and we need to fix it ASAP so that we don't confuse users as we support ACID transactions for multiple documents starting with CB 6.5.
Have discussed with Dave Rigby. We are supportive of the removal of the statement "Couchbase Server supports durability for single-document writes only. "
I beleive Tony Hillman is out this week therefore assigning to Ray Offiah
| Assignee | Tony Hillman [ tony.hillman ] | Ray Offiah [ JIRAUSER26039 ] |
Had a quick chat with Tony Hillman and wanted to clarify for all those on the ticket.
"Couchbase Server supports durability for single-document writes only. "
is a correct statement (assuming durability is the synonymous for synchronous write)
And in fact it would be incorrect to state
"Couchbase Server supports durability for multi-document writes. "
However from a development perspective we understand that including the statement "Couchbase Server supports durability for single-document writes only. " can be confusing to the developer. As from this the developer might assume we do not support transactions, when in fact we do as described https://docs.couchbase.com/server/current/learn/data/transactions.html
"Couchbase Server supports durability for single-document writes only. "
The above is a redundant statement which only causes harm rather than do any good. Please remove it.
https://github.com/couchbase/docs-server/pull/2233
| Resolution | Fixed [ 1 ] | |
| Status | In Progress [ 3 ] | Resolved [ 5 ] |
| Status | Resolved [ 5 ] | Closed [ 6 ] |
I've discussed this with Daniel Owen, and have confirmed that the statement is accurate. So, what might be the alternative phrasing?