add output

Author: rachel-mack

source/includes/run-command.kt

@@ -0,0 +1,22 @@
+import com.mongodb.kotlin.client.MongoClient
+import org.bson.Document
+
+fun main() {
+    //start-execute
+    val command = {
+        find: "restaurants",
+        filter: { cuisine: "Italian" },
+        projection: { name: 1, rating: 1, address: 1 },
+        sort: { name: 1 },
+        limit: 5
+      }
+    val commandResult = database.runCommand(command)
+    //end-execute
+
+    //start-read-preference
+    val command = { "hello": 1 }
+    val commandReadPreference = { readPreference: "secondary" }
+
+    val commandResult = database.runCommand(command, readPreference)
+    //end-read-preference
+}

source/run-command.txt

@@ -40,16 +40,12 @@ The following code shows how you can use the ``runCommand()``
 method to run the ``find`` command, which returns information about
 the current member's role in the replica set, on a database:
 
-.. code-block:: javascript
-
-   val command = {
-     find: "restaurants",
-     filter: { rating: { $gte: 9 }, cuisine: "italian" },
-     projection: { name: 1, rating: 1, address: 1 },
-     sort: { name: 1 },
-     limit: 5
-   }
-   val commandResult = database.runCommand(command)
+.. literalinclude:: /includes/run-command.kt
+   :start-after: start-execute
+   :end-before: end-execute
+   :language: kotlin
+   :copyable:
+   :dedent:
 
 For a full list of database commands and corresponding parameters, see
 the :manual:`Database Commands </reference/command/>` guide.
@@ -64,12 +60,12 @@ including a ``readPreference`` parameter. The following example shows how to
 specify a read preference and pass it as an option to the ``runCommand()``
 method:
 
-.. code-block:: javascript
-
-   val command = { "hello": 1 }
-   val commandReadPreference = { readPreference: "secondary" }
-
-   val commandResult = database.runCommand(command, readPreference)
+.. literalinclude:: /includes/run-command.kt
+   :start-after: start-read-preference
+   :end-before: end-read-preference
+   :language: kotlin
+   :copyable:
+   :dedent:
 
 For more information on read preference options, see :manual:`Read Preference
 </core/read-preference/>` in the Server manual. 
@@ -124,48 +120,33 @@ with the following fields:
 Example
 -------
 
-The following code shows how you can use the ``runCursorCommand()`` method to
-run the ``checkMetadataConsistency`` command on the ``testDB`` database
-and iterate through the results:
+The following code shows the general output format of the ``buildInfo`` command:
 
-.. literalinclude:: /code-snippets/crud/runCommand.js
-   :language: javascript
-   :dedent:
-   :start-after: start-runcommand
-   :end-before: end-runcommand
-
-Output
-~~~~~~
-
-The output contains the contents of the cursor object. The documents
-describe any metadata inconsistencies in the database:
-
-.. code-block:: javascript
-
-   {
-     type: ...,
-     description: ...,
-     details: {
-       namespace: ...,
-       info: ...
-     }
-   }
-   {
-     type: ...,
-     description: ...,
-     details: {
-       namespace: ...,
-       collectionUUID: ...,
-       maxKeyObj: ...,
-       ...
-     }
-   }
+.. io-code-block::
+
+   .. input:: /includes/aggregation/aggregation.kt
+      :language: kotlin
+      
+      db.runCommand( { buildInfo: 1 } );
+
+   .. output::
+      :visible: false
+        
+      {
+        version: '8.0.4',
+        <other command results>
+        storageEngines: [ ... ],
+        ok: 1,
+        '$clusterTime': {
+            clusterTime: Timestamp({ t: 1737993450, i: 32 }),
+            signature: {
+               ...
+            }
+        },
+        operationTime: Timestamp({ ... })
+      }
 
-.. note::
 
-   If you store the command response in a cursor, you see only the
-   command result documents when you access the contents of the cursor. You won't
-   see the ``ok``, ``operationTime``, and ``$clusterTime`` fields.
 
 .. _addl-info-runcommand:
 
@@ -175,7 +156,7 @@ Additional Information
 For more information about the concepts in this guide, see the following documentation:
 
 - Kotlin API
-   - :driver:`runCommand() <{+api+}/apidocs/mongodb-driver-kotlin-sync/mongodb-driver-kotlin-sync/com.mongodb.kotlin.client/-mongo-database/run-command.html>`
+   - `runCommand() <{+api+}/com.mongodb.kotlin.client/-mongo-database/run-command.html>`__
 - Database
    - :manual:`Database Commands </reference/command/>`
    - :manual:`hello Command </reference/command/hello/>`