DOCSP-31487: removed options for command() v6 (#737)

* DOCSP-31487: removed options for command() v6

* partial address of CC PR comments

* CC PR fixes all comments addressed

* small fixes

* fix

* CC PR fixes 2

* small fix

* CC PR fixes 3

* CC suggestion

Author: rustagir

source/fundamentals/run-command.txt

@@ -34,7 +34,7 @@ Execute a Command
 -----------------
 
 To run a database command, you must specify the command and any relevant
-parameters in a command document, then pass the command document to a
+parameters in a document, then pass this document to a
 command execution method. The {+driver-short+} provides the following methods
 to run database commands:
 
@@ -55,17 +55,54 @@ the current member's role in the replica set, on a database:
 For a full list of database commands and corresponding parameters, see
 the :ref:`Additional Information section <addl-info-runcommand>`.
 
+.. _node-command-options:
+
+Command Options
+---------------
+
+You can specify optional command behavior for the ``command()``
+and ``runCursorCommand()`` methods.
+
+The ``command()`` method accepts a ``RunCommandOptions`` object. To learn
+more about the ``RunCommandOptions`` type, see the `API documentation <{+api+}/types/RunCommandOptions.html>`__.
+
+The ``runCursorCommand() method`` accepts a ``RunCursorCommandOptions``
+object. To learn more about the ``RunCursorCommandOptions`` type, see
+the `API documentation <{+api+}/types/RunCursorCommandOptions.html>`__.
+
+Starting in version 6.0 of the {+driver-short+}, you can pass only the
+following options to the ``command()`` method:
+
+- ``comment``
+- ``enableUtf8Validation``
+- ``raw``
+- ``readPreference``
+- ``session``
+
+You can set additional options in the document that you pass to
+the ``command()`` method. To learn more about a command and the
+additional options that it accepts, locate the command and follow the
+link on the :manual:`Database Commands </reference/command/>` section of
+the Server manual.
+
+The following code shows how to specify a ``grantRolesToUser`` command
+that executes with a ``majority`` write concern:
+
+.. code-block:: javascript
+   :emphasize-lines: 4
+
+   const commandDoc = {
+       grantRolesToUser: "user011",
+       roles: [ "readWrite" ],
+       writeConcern: { w: "majority" }
+   };
+   const result = await myDB.command(commandDoc);
+
 .. note:: Read Preference
 
-   ``command()`` and ``runCursorCommand()`` do not obey the read
-   preference you may have set on your ``Db`` object elsewhere in
-   your code. By default, these methods use the ``primary`` read
-   preference.
-   
-   You can set a read preference for command execution by
-   passing an options object to either method. The ``command()`` method
-   takes a ``RunCommandOptions`` object, and the ``runCursorCommand()`` method
-   takes a ``RunCursorCommandOptions`` object.
+   The ``command()`` and ``runCursorCommand()`` methods ignore
+   the read preference setting you may have set on your ``Db`` object.
+   By default, these methods use the ``primary`` read preference.
 
    The following code shows how to specify a read preference and pass it
    as an option to the ``command()`` method:
@@ -178,6 +215,7 @@ For more information about the concepts in this guide, see the following documen
 - :manual:`db.runCommand() </reference/method/db.runCommand/>`
 - :manual:`Database Commands </reference/command/>`
 - :manual:`hello Command </reference/command/hello/>`
+- :manual:`find Command </reference/command/find/>`
 
 .. - :manual:`checkMetadataConsistency Command </reference/command/checkMetadataConsistency/>`
 

source/upgrade.txt

@@ -70,6 +70,10 @@ Version 6.x Breaking Changes
   ``tlsCertificateKeyFile`` connection options when you call the
   ``MongoClient.connect()`` method, not when you create the
   ``MongoClient`` instance.
+- The ``Db.command()`` method accepts only options that are not related
+  to a specific command. To learn more about these options, see the  
+  :ref:`Command Options <node-command-options>` section of the Run a
+  Command guide.
 - If you add ``mongodb-client-encryption`` as a dependency,
   the major version number must match that of the {+driver-short+}. For example,
   {+driver-short+} v6.x.x requires ``mongodb-client-encryption`` v6.x.x.

source/usage-examples/command.txt

@@ -4,20 +4,24 @@
 Run a Command
 =============
 
-You can run all raw database operations using the
-`db.command() <{+api+}/classes/Db.html#command>`__ method. Call the ``command()`` method with
-your command object on an instance of a database for diagnostic and
-administrative tasks such as fetching server stats or initializing a replica
-set.
-
-.. note::
-    Use the :mongosh:`MongoDB Shell </>` for administrative tasks instead of
-    the {+driver-short+} whenever possible.
-
-You can specify additional options in the ``options`` object passed in
-the second parameter of the ``command()`` method. For more information
-on the options you can pass, see the
-`db.command() API documentation <{+api+}/classes/Db.html#command>`__.
+You can execute database commands by using the
+`command() <{+api+}/classes/Db.html#command>`__ method on a ``Db``
+instance.
+
+You can specify a command and options in a document. To run the
+command, pass this document to the ``command()`` method. To see a full
+list of database commands, see :manual:`Database Commands
+</reference/command/>` in the Server manual.
+
+.. tip::
+   
+   Use the :mongosh:`MongoDB Shell </>` for administrative tasks instead of
+   the {+driver-short+} whenever possible.
+
+You can specify optional command behavior by passing a
+``RunCommandOptions`` object to the ``command()`` method. To learn more
+about the supported options, see the
+`Db.command() API documentation <{+api+}/classes/Db.html#command>`__.
 
 Example
 -------

source/whats-new.txt

@@ -110,6 +110,26 @@ The {+driver-short+} v6.0 release includes the following features:
   the ``MongoClient.connect()`` method, not when you create a
   ``MongoClient`` instance.
 
+- Removes the following options for the ``Db.command()`` method:
+  
+  - ``willRetryWrite``
+  - ``omitReadPreference``
+  - ``writeConcern``
+  - ``explain``
+  - ``readConcern``
+  - ``collation``
+  - ``maxTimeMS``
+  - ``comment``
+  - ``retryWrites``
+  - ``dbName``
+  - ``authdb``
+  - ``noResponse``
+
+  Although you cannot pass these options to the
+  ``Db.command()`` method, you can still set them in the command
+  document. To learn more, see the :ref:`Command Options
+  <node-command-options>` section of the Run a Command guide.
+
 .. _version-5.8:
 
 What's New in 5.8