(DOCSP-8054): run a command usage example (#25)

* update verbiage

* update TOC

* update TOC

* added command() method

* added missing link faq + more  description

* Fixed note syntax

* updated crud link

* test push

* (DOCSP-8054): Run a Command Usage Command init

* added code snippet for db.command

* updated verbiage

* updated verbiage per pr comments

* updated txt

* updated txt

Author: Mohammad Hunan Chughtai

source/code-snippets/usage-examples/command.js

@@ -0,0 +1,24 @@
+// ignored first line
+const { MongoClient } = require("mongodb");
+
+// Replace the following with your MongoDB deployment's connection string.
+const uri =
+  "mongodb+srv://<user>:<password>@<cluster-url>?retryWrites=true&w=majority";
+
+const client = new MongoClient(uri);
+
+async function run() {
+  try {
+    await client.connect();
+
+    const db = client.db("sample_mflix");
+    // find the storage statistics for the "sample_mflix" database using the 'dbStats' command
+    const result = await db.command({
+      dbStats: 1,
+    });
+    console.log(result);
+  } finally {
+    await client.close();
+  }
+}
+run().catch(console.dir);

source/usage-examples.txt

@@ -15,6 +15,7 @@ Usage Examples
 :doc:`updateOne</usage-examples/updateOne>`
 :doc:`replaceOne</usage-examples/replaceOne>`
 :doc:`distinct</usage-examples/distinct>`
+:doc:`command</usage-examples/command>`
 
 .. toctree::
    :caption: Examples
@@ -31,3 +32,4 @@ Usage Examples
    /usage-examples/updateOne
    /usage-examples/replaceOne
    /usage-examples/distinct
+   /usage-examples/command

source/usage-examples/command.txt

@@ -0,0 +1,31 @@
+=============
+Run A Command
+=============
+
+.. default-domain:: mongodb
+
+Overview
+--------
+
+You can run all raw database operations, not including :manual:`CRUD </crud/>`
+operations, using the :node-api:`command() </Admin.html#~command>`
+method. Typically ``command()`` is used for diagnostic and
+administrative tasks, such as fetching server stats or initializing a
+replica set. 
+
+.. note::
+    Use :manual:`collection methods </reference/method/js-collection>` instead of raw db commands whenever possible.
+
+Create an `Object
+<https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object>`_
+to specify additional options. Set the ``maxTimeMS`` field of this object to state 
+the number of milliseconds to wait before aborting the query.
+
+The ``command()`` method returns a `Promise
+<https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise>`_
+that resolves to an object containing the return object of the operation that was run.
+
+
+.. literalinclude:: /code-snippets/usage-examples/command.js
+  :language: javascript
+  :linenos:

source/usage-examples/missing-link.txt

@@ -1,2 +1,3 @@
 sasquatch?
-duplicate key error explanation
+duplicate key error explanation
+faq - diff b/w db.command({<crudMethod>}) and db.<crudMethod>