DOCSP-33147 improve serverStatus descriptions for metrics (#4805) (#4927)

* DOCSP-33147 improve serverStatus descriptions for metrics

* DOCSP-33147 improve serverStatus descriptions for metrics

* DOCSP-33147 improve serverStatus descriptions for metrics

* DOCSP-33147 improve serverStatus descriptions for metrics

* DOCSP-33147 active voice

* DOCSP-33147 active voice

* DOCSP-33147 consistency

* DOCSP-33147 consistency

* DOCSP-33147 copy edits

* DOCSP-33147 copy edits

* DOCSP-33147 typo

Author: ltran-mdb2

source/reference/command/serverStatus.txt

@@ -4693,27 +4693,27 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.countDonorMoveChunkStarted
 
-   The total number of times that the :dbcommand:`moveChunk` command
-   or :dbcommand:`moveRange` have started on the shard, of which this 
-   node is a member, as part of a :ref:`range migration process 
-   <range-migration-procedure>`. This increasing number does not 
+   The total number of times that MongoDB starts the
+   :dbcommand:`moveChunk` command or :dbcommand:`moveRange` command on
+   the primary node of the shard as part of the :ref:`range migration
+   procedure <range-migration-procedure>`. This increasing number does not
    consider whether the chunk migrations succeed or not.
 
    *Only present when run on a shard.*
 
 .. serverstatus:: shardingStatistics.countDonorMoveChunkCommitted
 
-   Total number of chunk migrations committed on the shard, of which
-   the current node is a member.
+   The total number of chunk migrations that MongoDB commits on the
+   primary node of the shard.
 
    .. include:: /includes/chunk-migrations.rst
 
    .. include:: /includes/chunk-migrations-version-list.rst
 
 .. serverstatus:: shardingStatistics.countDonorMoveChunkAborted
 
-   Total number of chunk migrations aborted on the shard, of which the
-   current node is a member.
+   The total number of chunk migrations that MongoDB aborts on the
+   primary node of the shard. 
 
    .. include:: /includes/chunk-migrations.rst
 
@@ -4733,32 +4733,30 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.totalDonorChunkCloneTimeMillis
 
-   The cumulative time, in milliseconds, taken by the :ref:`clone phase
-   of the range migrations <range-migration-procedure>` from this
-   shard, of which this node is a member. Specifically, for each
-   migration from this shard, the tracked time starts with the
-   :dbcommand:`moveRange` and :dbcommand:`moveChunk` commands and ends 
-   before the destination shard enters a ``catchup`` phase to apply 
-   changes that occurred during the :ref:`range migrations 
-   <range-migration-procedure>`.
+   The cumulative time, in milliseconds, that the :ref:`clone phase of
+   the range migration procedure <range-migration-procedure>` takes on
+   the primary node of the shard.  Specifically, for each migration on
+   this shard, the tracked time starts with the :dbcommand:`moveRange`
+   and :dbcommand:`moveChunk` commands and ends before the destination
+   shard enters a ``catchup`` phase to apply changes that occurred
+   during the :ref:`range migration procedure <range-migration-procedure>`.
 
    *Only present when run on a shard.*
 
 .. serverstatus:: shardingStatistics.totalCriticalSectionCommitTimeMillis
 
-   The cumulative time, in milliseconds, taken by the :ref:`update
-   metadata phase of the range migrations <range-migration-procedure>`
-   from this shard, of which this node is a member. During the update
-   metadata phase, all operations on the collection are blocked.
+   The cumulative time, in milliseconds, that the :ref:`update metadata
+   phase of the range migrations procedure <range-migration-procedure>`
+   takes on the primary node of the shard. During the update metadata
+   phase, MongoDB blocks all operations on the collection.
 
    *Only present when run on a shard.*
 
 .. serverstatus:: shardingStatistics.totalCriticalSectionTimeMillis
 
-   The cumulative time, in milliseconds, taken by the :ref:`catch-up
-   phase and the update metadata phase of the range migrations
-   <range-migration-procedure>` from this shard, of which this node is
-   a member.
+   The cumulative time, in milliseconds, that the :ref:`catch-up
+   phase and the update metadata phase of the range migration procedure
+   <range-migration-procedure>` takes on the primary node of the shard. 
 
    To calculate the duration of the catch-up phase, subtract
    :serverstatus:`~shardingStatistics.totalCriticalSectionCommitTimeMillis` from
@@ -4772,20 +4770,18 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.countDocsClonedOnRecipient
 
-   Cumulative, always-increasing count of documents that have been
-   cloned on this member where it acted as the primary of the recipient
-   shard.
+   The cumulative, always-increasing count of documents that MongoDB
+   clones on the primary node of the recipient shard.
 
    *Only present when run on a shard.*
 
    .. versionadded:: 4.2
 
 .. serverstatus:: shardingStatistics.countBytesClonedOnRecipient
 
-   Cumulative number of bytes cloned on the current member node during a
-   :ref:`range migration procedure <range-migration-procedure>`, where
-   the current member node acted as the primary node for the recipient
-   shard.
+   The cumulative number of bytes that MongoDB clones on the primary
+   node of the recipient shard during the :ref:`range migration procedure
+   <range-migration-procedure>`. 
 
    .. include:: /includes/chunk-migrations-data-copy.rst
 
@@ -4795,10 +4791,9 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.countDocsClonedOnCatchUpOnRecipient
 
-   Cumulative number of documents cloned on the current member node
-   during the catch-up phase of a :ref:`range migration procedure
-   <range-migration-procedure>`, where the current member node acted as
-   the primary node for the recipient shard.
+   The cumulative number of documents that MongoDB clones on the primary
+   node of the recipient shard during the catch-up phase of the
+   :ref:`range migration procedure <range-migration-procedure>`. 
 
    .. include:: /includes/chunk-migrations-data-copy.rst
 
@@ -4808,10 +4803,9 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.countBytesClonedOnCatchUpOnRecipient
 
-   Cumulative number of bytes cloned on the current member node during
-   the catch-up phase of a :ref:`range migration procedure
-   <range-migration-procedure>`, where the current member node acted as
-   the primary node for the recipient shard.
+   The cumulative number of bytes that MongoDB clones on the primary
+   node of the recipient shard during the catch-up phase of the
+   :ref:`range migration procedure <range-migration-procedure>`. 
 
    .. include:: /includes/chunk-migrations-data-copy.rst
 
@@ -4821,9 +4815,8 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.countDocsClonedOnDonor
 
-   Cumulative, always-increasing count of documents that haves been
-   cloned on this member where it acted as the primary of the donor
-   shard.
+   The cumulative, always-increasing count of documents that MongoDB
+   clones on the primary node of the donor shard. 
 
    *Only present when run on a shard.*
 
@@ -4841,9 +4834,9 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.countDocsDeletedByRangeDeleter
 
-   Cumulative, always-increasing count of documents that have been
-   deleted on this member during chunk migration where the member acted
-   as the primary of the donor shard.
+   The cumulative, always-increasing count of documents that MongoDB
+   deletes on the primary node of the donor shard during chunk
+   migration. 
 
    *Only present when run on a shard.*
 
@@ -4853,9 +4846,9 @@ shardingStatistics
 
 .. serverstatus:: shardingStatistics.countDonorMoveChunkLockTimeout
 
-   Cumulative, always-increasing count of chunk migrations that were
-   aborted due to lock acquisition timeouts, where the member acted as
-   the primary of the donor shard.
+   The cumulative, always-increasing count of chunk migrations that MongoDB
+   aborts on the primary node of the donor shard due to lock acquisition
+   timeouts.
 
    *Only present when run on a shard.*
 
@@ -4932,7 +4925,7 @@ shardingStatistics
 
    The current total of the queued chunk range deletion tasks that are
    ready to run or are running as part of the :ref:`range migration
-   process <range-migration-procedure>`.
+   procedure <range-migration-procedure>`.
 
    Inspect the documents in the :data:`config.rangeDeletions` collection
    for information about the chunk ranges pending deletion from a shard