DOCS-983 splitting chunks review edits

Author: Bob Grabar

source/includes/warning-splitting-chunks.rst

@@ -0,0 +1,9 @@
+.. warning::
+
+   Be careful when splitting chunks. When you shard a collection that
+   has existing data, MongoDB automatically creates chunks to evenly
+   spread the collection. Performing additional splits requires
+   knowledge of the resulting chunk sizes by numbers of documents and by
+   size. You do not want splits that cause some chunks to be much larger
+   than others. This leads to balancing based on count of chunks, not on
+   their size, which may cause extreme load/data-distribution problems.

source/reference/command/split.txt

@@ -12,20 +12,10 @@ split
    this command makes it possible for administrators to manually
    create splits.
 
-   In normal operation there is no need to manually split chunks. The
-   :term:`balancer` and other sharding infrastructure will automatically
-   create chunks in the course of normal operations. See
-   :doc:`/core/sharded-cluster-internals` for more information.
-
-.. warning::
-
-   Be careful when splitting chunks. When you shard a collection that
-   has existing data, MongoDB automatically creates chunks to evenly
-   spread the collection. Performing additional splits requires
-   knowledge of the resulting chunk sizes by numbers of documents and by
-   size. You do not want splits that cause some chunks to be much larger
-   than others. This leads to balancing based on count of chunks, not on
-   their size, which may cause extreme load/data-distribution problems.
+   In most clusters, MongoDB will manage all chunk creation and
+   distribution operations without manual intervention.
+
+.. include:: /includes/warning-splitting-chunks.rst
 
    Consider the following example:
 

source/reference/command/splitChunk.txt

@@ -10,14 +10,6 @@ splitChunk
    :method:`sh.splitFind()` and :method:`sh.splitAt()` functions in the
    :program:`mongo` shell to access this functionality.
 
-.. warning::
-
-   Be careful when splitting chunks. When you shard a collection that
-   has existing data, MongoDB automatically creates chunks to evenly
-   spread the collection. Performing additional splits requires
-   knowledge of the resulting chunk sizes by numbers of documents and by
-   size. You do not want splits that cause some chunks to be much larger
-   than others. This leads to balancing based on count of chunks, not on
-   their size, which may cause extreme load/data-distribution problems.
+.. include:: /includes/warning-splitting-chunks.rst
 
    .. admin-only.

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

@@ -58,15 +58,7 @@ You may want to split chunks manually if:
    values between ``300`` and ``400``, *but* all values of your shard
    keys are between ``250`` and ``500`` are in a single chunk.
 
-.. warning::
-
-   Be careful when splitting chunks. When you shard a collection that
-   has existing data, MongoDB automatically creates chunks to evenly
-   spread the collection. Performing additional splits requires
-   knowledge of the resulting chunk sizes by numbers of documents and by
-   size. You do not want splits that cause some chunks to be much larger
-   than others. This leads to balancing based on count of chunks, not on
-   their size, which may cause extreme load/data-distribution problems.
+.. include:: /includes/warning-splitting-chunks.rst
 
 Use :method:`sh.status()` to determine the current chunks ranges across
 the cluster.