(DOCSP-13189): Remove deprecated CRUD commands (#79)

* (DOCSP-13189): Remove deprecated CRUD commands

(DOCSP-13189): Remove deprecated CRUD commands

* Updates per copy review

Author: jeff-allen-mongo

source/index.txt

@@ -124,3 +124,4 @@ Learn More
       /logs
       /reference
       /changelog
+      /reference/compatibility

source/logs.txt

@@ -1,8 +1,8 @@
 .. _mdb-shell-logs:
 
-===========================
-Retrieve MongoDB Shell Logs
-===========================
+===================
+Retrieve Shell Logs
+===================
 
 .. default-domain:: mongodb
 

source/reference/compatibility.txt

@@ -0,0 +1,54 @@
+.. _compatibility:
+
+=================================================
+Compatibility Changes with Legacy ``mongo`` Shell
+=================================================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The following behaviors in ``mongosh`` affect compatibility with
+operations performed in the legacy ``mongo`` shell.
+
+Deprecated Methods
+------------------
+
+The following shell methods are deprecated in ``mongosh``. Instead, use
+the methods listed in the :guilabel:`Alternative Methods` column.
+
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 10
+
+   * - Deprecated Method
+     - Alternative Methods
+   
+   * - ``db.collection.insert()``
+     - - :method:`db.collection.insertOne()`
+       - :method:`db.collection.insertMany()`
+       - :method:`db.collection.bulkWrite()`
+
+   * - ``db.collection.remove()``
+     - - :method:`db.collection.deleteOne()`
+       - :method:`db.collection.deleteMany()`
+       - :method:`db.collection.findOneAndDelete()`
+       - :method:`db.collection.bulkWrite()`
+
+   * - ``db.collection.save()``
+     - - :method:`db.collection.insertOne()`
+       - :method:`db.collection.insertMany()`
+       - :method:`db.collection.updateOne()`
+       - :method:`db.collection.updateMany()`
+       - :method:`db.collection.findOneAndUpdate()`
+
+
+   * - ``db.collection.update()``
+     - - :method:`db.collection.updateOne()`
+       - :method:`db.collection.updateMany()`
+       - :method:`db.collection.findOneAndUpdate()`
+       - :method:`db.collection.bulkWrite()`
+

source/reference/methods.txt

@@ -278,10 +278,6 @@ Collection Methods
      - Provides a wrapper for the database command :manual:`getShardVersion
        </reference/command/getShardVersion/>`.
 
-   * - :method:`db.collection.insert()`
-
-     - Creates a new document in a collection.
-
    * - :method:`db.collection.insertOne()`
 
      - Inserts a new document in a collection.
@@ -302,10 +298,6 @@ Collection Methods
 
      - Rebuilds all existing indexes on a collection.
 
-   * - :method:`db.collection.remove()`
-
-     - Deletes documents from a collection.
-
    * - :method:`db.collection.renameCollection()`
 
      - Changes the name of a collection.
@@ -314,11 +306,6 @@ Collection Methods
 
      - Replaces a single document in a collection.
 
-   * - :method:`db.collection.save()`
-
-     - Provides a wrapper around :method:`~db.collection.insert()`
-       and :method:`~db.collection.update()` to insert new documents.
-
    * - :method:`db.collection.stats()`
 
      - Reports on the state of a collection. Provides a wrapper around
@@ -341,10 +328,6 @@ Collection Methods
      - Reports the total size of a collection, including the size of
        all documents and all indexes on a collection.
 
-   * - :method:`db.collection.update()`
-
-     - Modifies a document in a collection.
-
    * - :method:`db.collection.updateOne()`
 
      - Modifies a single document in a collection.

source/write-scripts.txt

@@ -1,7 +1,7 @@
 .. _mdb-shell-write-scripts:
 
 =================================
-Write Scripts for the |mdb-shell|
+Write Scripts for the ``mongosh``
 =================================
 
 .. default-domain:: mongodb