This is an automated email from the ASF dual-hosted git repository. rnewson pushed a commit to branch clarify-quorum in repository https://gitbox.apache.org/repos/asf/couchdb.git
commit bb1216593531cdb821a1c9fb0d1442a275799ea8 Author: Robert Newson <[email protected]> AuthorDate: Sun Jun 11 08:33:35 2023 +0100 clarify default quorum calculation --- src/docs/src/cluster/sharding.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/src/docs/src/cluster/sharding.rst b/src/docs/src/cluster/sharding.rst index d7bc3e262..55243805e 100644 --- a/src/docs/src/cluster/sharding.rst +++ b/src/docs/src/cluster/sharding.rst @@ -93,10 +93,11 @@ include itself. The coordinating node sends a response to the client once a `quorum <https://en.wikipedia.org/wiki/Quorum_(distributed_computing)>`__ of database nodes have responded; 2, by default. The default required size -of a quorum is equal to ``r=w=((n+1)/2)`` where ``r`` refers to the size -of a read quorum, ``w`` refers to the size of a write quorum, and ``n`` -refers to the number of replicas of each shard. In a default cluster where -``n`` is 3, ``((n+1)/2)`` would be 2. +of a quorum is equal to ``r=w=((n div 2) + 1)`` where ``r`` refers to the size +of a read quorum, ``w`` refers to the size of a write quorum, ``n`` +refers to the number of replicas of each shard, and ``div`` is integer division, +rounding down. In a default cluster where +``n`` is 3, ``((n div 2) + 1)`` would be 2. .. note:: Each node in a cluster can be a coordinating node for any one
