edits: DOCS-461

Author: Sam Kleinman

source/core/sharded-cluster-internals.txt

@@ -464,10 +464,7 @@ command. This will prevent the :term:`balancer` from migrating chunks
 to the shard when the value of :data:`mem.mapped <serverStatus.mem.mapped>` 
 exceeds the ``maxSize`` setting.
 
-.. seealso:: 
-
-   :ref:`sharded-cluster-config-max-shard-size`
-
+.. seealso:: :ref:`sharded-cluster-config-max-shard-size` and
    :doc:`/administration/monitoring`.
 
 .. _sharding-chunk-migration:

source/reference/command/moveChunk.txt

@@ -7,7 +7,7 @@ moveChunk
 .. dbcommand:: moveChunk
 
    :dbcommand:`moveChunk` is an internal administrative command that
-   moves :term:`chunks <chunk>` between :term:`shards <shard>`. 
+   moves :term:`chunks <chunk>` between :term:`shards <shard>`.
    You must issue the
    :dbcommand:`moveChunk`
    command against the :term:`admin database` in the form:
@@ -19,22 +19,28 @@ moveChunk
                        to : <destination>,
                        <options> } )
 
-   :param moveChunk: The name of the :term:`collection` where
-                     the :term:`chunk` exists. Specify the 
-                     collection's full namespace, including
-                     the database name. 
+   :param namespace moveChunk:
 
-   :param find: A document including the :term:`shard key`.
+      The name of the :term:`collection` where the :term:`chunk`
+      exists. Specify the collection's full namespace, including the
+      database name.
 
-   :param to: The identifier of the shard, that you want to migrate the
-              chunk to.
+   :param document find:
 
-   :param _secondaryThrottle: Optional. Set to ``false`` by default. If
-                              set to ``true``, the balancer waits for
-                              replication to :term:`secondaries <secondary>`
-                              while copying and deleting
-                              data during migrations. For details, see
-                              :ref:`sharded-cluster-config-secondary-throttle`.
+      A document including the :term:`shard key`.
+
+   :param host to:
+
+      The identifier of the shard, that you want to migrate the chunk
+      to.
+
+   :param boolean _secondaryThrottle:
+
+      Optional. Set to ``false`` by default. If set to ``true``, the
+      balancer waits for replication to :term:`secondaries
+      <secondary>` while copying and deleting data during
+      migrations. For details, see
+      :ref:`sharded-cluster-config-secondary-throttle`.
 
    Use the :method:`sh.moveChunk()` helper in the :program:`mongo`
    shell to migrate chunks manually.

source/tutorial/configure-sharded-cluster-balancer.txt

@@ -6,13 +6,14 @@ Configure Behavior of Balancer Process in Sharded Clusters
 
 .. default-domain:: mongodb
 
-The balancer runs on a single :program:`mongos` instance and distributes
-chunks evenly throughout a sharded cluster. In most deployments, you do
-not need to configure the balancer. The balancer automatically
-distributes chunks in an optimal manner. However, administrators might
-need to modify balancer behavior depending on application or operational
-requirements. Should a situation arise where modifying balancer behavior
-is necessary, this page describes settings that can be changed.
+The balancer is a process that runs on *one* of the :program:`mongos`
+instances in a cluster and ensures that :term:`chunks <chunk>` are
+evenly distributed throughout a sharded cluster. In most deployments,
+the default balancer configuration is sufficient for normal
+operation. However, administrators might need to modify balancer
+behavior depending on application or operational requirements. If you
+encounter a situation where you need to modify the behavior of the
+balancer, use the procedures described in this document.
 
 For conceptual information about the balancer, see
 :ref:`sharding-balancing` and :ref:`sharding-balancing-internals`.
@@ -22,17 +23,17 @@ For conceptual information about the balancer, see
 Schedule a Window of Time for Balancing to Occur
 ------------------------------------------------
 
-You can schedule a window of time during which the balancer is allowed
-to migrate chunks, as described in the following procedures:
+You can schedule a window of time during which the balancer can
+migrate chunks, as described in the following procedures:
 
 - :ref:`sharding-schedule-balancing-window`
 
 - :ref:`sharding-balancing-remove-window`.
 
-The configured time is evaluated relative to the time zone of each
-individual :program:`mongos` instance in the sharded cluster.
+The :program:`mongos` instances user their own local timezones to when
+respecting balancer window.
 
-.. _sharded-cluster-config-default-chunk-size:
+.. _sharded-cluster-config-default-chunk-size:q
 
 Configure Default Chunk Size
 ----------------------------

source/tutorial/manage-chunks-in-sharded-cluster.txt

@@ -1,5 +1,3 @@
-.. _sharding-manage-chunks:
-
 ==================================
 Manage Chunks in a Sharded Cluster
 ==================================
@@ -13,18 +11,6 @@ operations are accessible to administrators for use in some
 situations, typically surrounding initial setup, deployment, and data
 ingestion.
 
-This page includes the following:
-
-- :ref:`sharding-administration-create-chunks`
-
-- :ref:`sharding-balancing-modify-chunk-size`
-
-- :ref:`sharding-balancing-manual-migration`
-
-- :ref:`sharding-bulk-inserts`
-
-- :ref:`sharding-procedure-create-split`
-
 .. _sharding-procedure-create-split:
 
 Split Chunks

source/tutorial/manage-sharded-cluster-balancer.txt

@@ -11,19 +11,7 @@ to balancing. For an introduction to balancing, see
 :ref:`sharding-balancing`. For lower level information on balancing, see
 :ref:`sharding-balancing-internals`.
 
-This page includes the following:
-
-- :ref:`sharding-balancing-check-lock`
-
-- :ref:`sharding-schedule-balancing-window`
-
-- :ref:`sharding-balancing-remove-window`
-
-- :ref:`sharding-balancing-disable-temporally`
-
-.. seealso::
-
-   :doc:`/tutorial/configure-sharded-cluster-balancer`
+.. seealso:: :doc:`/tutorial/configure-sharded-cluster-balancer`
 
 .. _sharding-balancing-check-lock: