This is an automated email from the ASF dual-hosted git repository.
jan pushed a commit to branch doc/quorum
in repository https://gitbox.apache.org/repos/asf/couchdb.git
commit 7e171181d313fa835d912b30961797a0434fb77c
Author: Jan Lehnardt <j...@apache.org>
AuthorDate: Mon Nov 27 15:17:13 2023 +0100
doc: take out w + n params, folks get confused.
---
src/docs/src/cluster/sharding.rst | 27 ---------------------------
1 file changed, 27 deletions(-)
diff --git a/src/docs/src/cluster/sharding.rst
b/src/docs/src/cluster/sharding.rst
index 7b8ca52ff..0d8c6d78c 100644
--- a/src/docs/src/cluster/sharding.rst
+++ b/src/docs/src/cluster/sharding.rst
@@ -103,33 +103,6 @@ rounding down. In a default cluster where
Each node in a cluster can be a coordinating node for any one
request. There are no special roles for nodes inside the cluster.
-The size of the required quorum can be configured at request time by
-setting the ``r`` parameter for document reads, and the ``w``
-parameter for document writes. The ``_view``, ``_find``, and
-``_search`` endpoints read only one copy no matter what quorum is
-configured, effectively making a quorum of 1 for these requests.
-
-For example, here is a request that directs the coordinating node to
-send a response once at least two nodes have responded:
-
-.. code-block:: bash
-
- $ curl "$COUCH_URL:5984/{db}/{doc}?r=2"
-
-Here is a similar example for writing a document:
-
-.. code-block:: bash
-
- $ curl -X PUT "$COUCH_URL:5984/{db}/{doc}?w=2" -d '{...}'
-
-Setting ``r`` or ``w`` to be equal to ``n`` (the number of replicas)
-means you will only receive a response once all nodes with relevant
-shards have responded or timed out, and as such this approach does not
-guarantee `ACIDic consistency
-<https://en.wikipedia.org/wiki/ACID#Consistency>`__. Setting ``r`` or
-``w`` to 1 means you will receive a response after only one relevant
-node has responded.
-
.. _cluster/sharding/examine:
Examining database shards
