NH feedback

Author: rachel-mack

source/includes/run-command.kt

@@ -1,20 +1,42 @@
+//start-full-example
+import com.mongodb.MongoException
 import com.mongodb.kotlin.client.MongoClient
 import org.bson.Document
+import org.bson.BsonInt64
+import org.bson.json.JsonWriterSettings
+
 
 fun main() {
+    // Replace the placeholder with your MongoDB deployment's connection string
+    val uri = "<connection string uri>"
+
+    val mongoClient = MongoClient.create(uri)
+    val database = mongoClient.getDatabase("sample_mflix")
+    try {
+        val command = Document("buildInfo", BsonInt64(1))
+        val commandResult = database.runCommand(command)
+        println(commandResult.toJson(JsonWriterSettings.builder().indent(true).build()))
+    } catch (me: MongoException) {
+        System.err.println("An error occurred: $me")
+    }
+    mongoClient.close()
+}
+//end-full-example
+
+fun command_examples() {
     //start-execute
-    val commandToExplain = Document( "find", "restaurants")
+    val commandToExplain = Document("find", "restaurants")
     val explanation = database.runCommand(Document("explain", commandToExplain))
     //end-execute
 
     //start-read-preference
     val command = Document("hello", 1)
-    val commandReadPreference = Document( "readPreference", "secondary" )
+    val commandReadPreference = Document("readPreference", "secondary")
 
     val commandResult = database.runCommand(command, commandReadPreference)
     //end-read-preference
 
     //start-build-info
-    println( database.runCommand( Document( "buildInfo", 1 ) );
+    println(database.runCommand(Document("buildInfo", 1));
     //end-build-info
 }

source/run-command.txt

@@ -13,7 +13,7 @@ Run a Command
 Overview
 --------
 
-In this guide, you can learn how to run a database command with the
+In this guide, you can learn how to run a database command by using the
 {+driver-short+}. You can use database commands to perform a variety of
 administrative and diagnostic tasks, such as fetching server statistics,
 initializing a replica set, or running an aggregation pipeline.
@@ -125,8 +125,8 @@ The following code shows the general output format of the ``buildInfo`` command:
 .. io-code-block::
 
    .. input:: /includes/run-command.kt
-      :start-after: start-build-info
-      :end-before: end-build-info
+      :start-after: start-full-example
+      :end-before: end-full-example
       :language: kotlin
       :dedent:
 
@@ -135,11 +135,10 @@ The following code shows the general output format of the ``buildInfo`` command:
 
       {
         version: '8.0.4',
-        <other command results>
-        storageEngines: [ ... ],
+         ...<other command results>...
         ok: 1,
         '$clusterTime': {
-            clusterTime: Timestamp({ t: 1737993450, i: 32 }),
+            clusterTime: Timestamp({ ... }),
             signature: {
                ...
             }