In "Shards and Replicas", notes effect of [peruser] q config (#755)
Shards and Replicas: notes default for [couch_peruser] q
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 @@
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
