[couchdb-documentation] branch main updated: In "Shards and Replicas", notes effect of [peruser] q config (#755)

[va...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

vatamane pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git


The following commit(s) were added to refs/heads/main by this push:
     new 0d8b774  In "Shards and Replicas", notes effect of [peruser] q config (#755)
0d8b774 is described below

commit 0d8b7744645460f0fb4b22c241ece66228a9f04f
Author: Doug Reeder <re...@gmail.com>
AuthorDate: Mon Aug 29 15:20:12 2022 -0400

    In "Shards and Replicas", notes effect of [peruser] q config (#755)
    
    Shards and Replicas: notes default for [couch_peruser] q
---
 src/cluster/sharding.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/cluster/sharding.rst b/src/cluster/sharding.rst
index 6293424..d7bc3e2 100644
--- a/src/cluster/sharding.rst
+++ b/src/cluster/sharding.rst
@@ -64,9 +64,12 @@ CouchDB nodes have a ``etc/default.ini`` file with a section named
 
 These settings specify the default sharding parameters for newly created
 databases. These can be overridden in the ``etc/local.ini`` file by copying the
-text above, and replacing the values with your new defaults.  The values can
-also be set on a per-database basis by specifying the ``q`` and ``n`` query
-parameters when the database is created. For example:
+text above, and replacing the values with your new defaults.
+If ``[couch_peruser]`` ``q`` is set, that value is used for per-user databases.
+(By default, it is set to 1, on the assumption that per-user dbs will be quite
+small and there will be many of them.)  The values can also be set on a
+per-database basis by specifying the ``q`` and ``n`` query parameters when the
+database is created. For example:
 
 .. code-block:: bash