Removing references to voting and adding info about nodes with buildIndexes:false (#940) (#975)

mdb-ashley · web-flow · commit c3c19105c660 · 2022-04-18T11:06:48.000-04:00
* Removing references to voting and adding info about nodes with buildIndexes:false

* Minor fixes

* Updating buildIndex:false information

* Bugfix

* Incorporating review comments

* Incorporating external review comments
diff --git a/source/reference/command/createIndexes.txt b/source/reference/command/createIndexes.txt
@@ -82,43 +82,39 @@ Definition
         - Optional. A document expressing the :doc:`write concern
           </reference/write-concern>`. Omit to use the default write concern.
 
-      * - :ref:`commitQuorum <createIndexes-cmd-commitQuorum>`
+      * - ``commitQuorum``
 
         - integer or string
 
         - .. _createIndexes-cmd-commitQuorum:
         
-          Optional. The minimum number of data-bearing voting replica
+          Optional. The minimum number of data-bearing replica
           set members (i.e. commit quorum), including the primary, that
           must report a successful :ref:`index build
           <index-operations-replicated-build>` before the primary
-          marks the ``indexes`` as ready. A "voting" member is any
-          replica set member where :rsconf:`members[n].votes` is greater
-          than ``0``.
+          marks the ``indexes`` as ready. 
 
-          Starting in MongoDB v5.0 you can resume some
+          Starting in MongoDB v5.0, you can resume some
           :ref:`interupted index builds<index-operations-build-failure>`
           when the
           :dbcommand:`commit quorum is set<setIndexCommitQuorum>` to
           ``"votingMembers"``. 
 
-          The ``"votingMembers"`` commit quorum cannot be used if any 
-          voting replica set node is configured with 
-          :rsconf:`members[n].buildIndexes` set to ``false``. Either 
-          configure all nodes with :rsconf:`members[n].buildIndexes` set 
-          to ``true`` or select a commit quorum that requires fewer 
-          votes.
+          Replica set nodes in a commit quorum must have :rsconf:`members[n].buildIndexes` 
+          set to ``true``. If any voting nodes have ``members[n].buildIndexes`` 
+          set to ``false``, you can't use the default ``"votingMembers"`` commit 
+          quorum. Either configure all nodes with ``members[n].buildIndexes`` 
+          set to ``true``, or select a different commit quorum.  
 
           Supports the following values:
 
           - ``"votingMembers"`` - all data-bearing voting replica set
-            members (*Default*).
+            members (*Default*). A "voting" member is any replica set member 
+            where :rsconf:`members[n].votes` is greater than ``0``.
 
-          - ``"majority"`` - a simple majority of data-bearing voting
-            replica set members.
+          - ``"majority"`` - a simple majority of data-bearing replica set members.
 
-          - ``<int>`` - a specific number of data-bearing voting 
-            replica set members.
+          - ``<int>`` - a specific number of data-bearing replica set members.
 
           - ``0`` - Disables quorum-voting behavior. Members 
             start the index build simultaneously but do *not* 
@@ -989,11 +985,11 @@ to the :dbcommand:`createIndexes` operation to set the minimum
 number of data-bearing voting members (i.e commit quorum), including the
 primary, which must complete the index build before the
 primary marks the indexes as ready. The default commit quorum is
-``votingMembers``, or all data-bearing voting replica set members.
+``votingMembers``, or all data-bearing replica set members.
 
 The following operation creates an index with a :ref:`commit quorum
 <createIndexes-cmd-commitQuorum>` of ``"majority"``, or a 
-simple majority of data-bearing voting members:
+simple majority of data-bearing members:
 
 .. code-block:: javascript
 
diff --git a/source/reference/command/setIndexCommitQuorum.txt b/source/reference/command/setIndexCommitQuorum.txt
@@ -69,34 +69,32 @@ setIndexCommitQuorum
 
         - .. _setIndexCommitQuorum-cmd-commitQuorum:
         
-          The minimum number of data-bearing voting replica
+          The minimum number of data-bearing replica
           set members (i.e. commit quorum), including the primary, that
           must report a successful :ref:`index build
           <index-operations-replicated-build>` before the primary
-          marks the ``indexes`` as ready. A "voting" member is any
-          replica set member where :rsconf:`members[n].votes` is
-          greater than ``0``.
+          marks the ``indexes`` as ready.
           
-          Starting in MongoDB v5.0 it is possible to resume some
+          Starting in MongoDB v5.0, it's possible to resume some
           :ref:`interupted index builds<index-operations-build-failure>`
           when the commit quorum is set to ``"votingMembers"``. 
           
-          The ``"votingMembers"`` commit quorum cannot be used if any 
-          voting replica set node is configured with 
-          :rsconf:`members[n].buildIndexes` set to ``false``. Either 
-          configure all nodes with :rsconf:`members[n].buildIndexes` set 
-          to ``true`` or select a commit quorum that requires fewer 
-          votes. 
+          Replica set nodes in a commit quorum must have :rsconf:`members[n].buildIndexes` 
+          set to ``true``. If any voting nodes have ``members[n].buildIndexes`` 
+          set to ``false``, you can't use the default ``"votingMembers"`` commit 
+          quorum. Either configure all nodes with ``members[n].buildIndexes`` 
+          set to ``true``, or select a different commit quorum. 
 
           Supports the following values:
 
           - ``"votingMembers"`` - all data-bearing voting replica set
-            members. (*Default*)
+            members (*Default*). A "voting" member is any replica set member 
+            where :rsconf:`members[n].votes` is greater than ``0``.
 
-          - ``"majority"`` - a simple majority of data-bearing voting
+          - ``"majority"`` - a simple majority of data-bearing
             replica set members.
 
-          - ``<int>`` - a specific number of data-bearing voting 
+          - ``<int>`` - a specific number of data-bearing 
             replica set members. Specify an integer greater than 
             ``0``.
 
@@ -122,6 +120,11 @@ Issuing :dbcommand:`setIndexCommitQuorum` has no effect on index builds
 started with :ref:`commitQuorum <createIndexes-cmd-commitQuorum>` of
 ``0``. 
 
+.. important:: 
+
+   Replica set nodes with :ref:`buildIndexes <replica-set-configuration-buildIndexes>` 
+   set to ``false`` can't be included in a commit quorum.
+
 Examples
 --------
 
diff --git a/source/reference/replica-configuration.txt b/source/reference/replica-configuration.txt
@@ -177,6 +177,8 @@ Replica Set Configuration Fields
       - :ref:`wc-ack-behavior`
       - :doc:`/reference/replica-set-protocol-versions`
 
+.. _replica-set-configuration-buildIndexes:
+
 ``members``
 ~~~~~~~~~~~
 
