DOCS-12222: 4.2 - deprecate cloneCollection

Author: kay-kim

source/reference/command/cloneCollection.txt

@@ -15,6 +15,12 @@ Definition
 
 .. dbcommand:: cloneCollection
 
+   .. deprecated:: 4.2
+
+      MongoDB deprecates :dbcommand:`cloneCollection` and its helper
+      :method:`db.cloneCollection()`. For alternatives, see
+      :ref:`4.2-compat-clone-collection`.
+
    Copies a collection from a remote :binary:`~bin.mongod` instance to the
    current :binary:`~bin.mongod` instance. :dbcommand:`cloneCollection`
    creates a collection in a database with the same name as the remote
@@ -33,7 +39,7 @@ Definition
 
    .. include:: /includes/apiargs/dbcommand-cloneCollection-field.rst
 
-   The :program:`mongo` shell provides the method
+   The :binary:`~bin.mongo` shell provides the method
    :method:`db.cloneCollection()` as a wrapper for the
    :dbcommand:`cloneCollection` command.
 

source/reference/method/db.cloneCollection.txt

@@ -15,6 +15,12 @@ Definition
 
 .. method:: db.cloneCollection(from, collection, query)
 
+   .. deprecated:: 4.2
+
+      MongoDB deprecates :dbcommand:`cloneCollection` and its helper
+      :method:`db.cloneCollection()`. For alternatives, see
+      :ref:`4.2-compat-clone-collection`.
+   
    Copies data directly between MongoDB instances. The
    :method:`db.cloneCollection()` method wraps the
    :dbcommand:`cloneCollection` command and accepts the

source/release-notes/4.2-compatibility.txt

@@ -95,8 +95,8 @@ MongoDB removes the MMAPv1 specific options:
 - ``paddingFactor``, ``paddingBytes``, ``preservePadding`` for
   :method:`db.createCollection()`.
 
-Removed Commands and Methods
-----------------------------
+Removed or Deprecated Commands and Methods
+------------------------------------------
 
 .. _4.2-compat-remove-group:
 
@@ -218,6 +218,20 @@ As alternatives:
   :doc:`/tutorial/recover-data-following-unexpected-shutdown` for
   details.
 
+.. _4.2-compat-clone-collection:
+
+Deprecate Support for ``cloneCollection``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+MongoDB deprecates the :dbcommand:`cloneCollection` command and its
+:binary:`~bin.mongo` shell helper :method:`db.cloneCollection()`
+
+As alternatives, 
+
+- Users can use the :pipeline:`$out` aggregation stage. 
+
+- Users can use :binary:`~bin.mongoexport` and
+  :binary:`~bin.mongoimport` or write a script using the drivers.
 
 Aggregation
 -----------