new option for connecting

Author: lindseymoore

source/connect/mongoclient.txt

@@ -24,10 +24,10 @@ To connect to a MongoDB deployment, you need two things:
 
 - A **connection URI**, also known as a *connection string*, which tells the {+driver-short+}
   which MongoDB deployment to connect to.
-- A **MongoClient** object, which creates the connection to and perform 
+- A **MongoClient** object, which creates the connection to and performs 
   operations on the MongoDB deployment.
 
-You can also use either of these components to customize the way the {+driver-short+} behaves
+You can also use ``MongoClientSettings`` to customize the way the {+driver-short+} behaves
 while connected to MongoDB.
 
 This guide shows you how to create a connection string and use a ``MongoClient`` object
@@ -40,8 +40,8 @@ Connection URI
 
 A standard connection string includes the following components:
 
-.. TODO, add this as last sentence for ``username:password`` description: For more information about the ``authSource`` 
-.. connection option, see :ref:`kotlin-sync-auth`. 
+.. TODO, add this as last sentence for ``username:password`` description once a kotlin auth page is made: 
+.. For more information about the ``authSource`` connection option, see :ref:`kotlin-sync-auth`. 
 
 .. list-table::
    :widths: 20 80
@@ -87,7 +87,18 @@ Atlas Connection Example
 ------------------------
 
 To connect to a MongoDB deployment on Atlas, you must first create a client. 
-You can create a client with your desired configurations by passing a 
+
+You can pass a connection URI as a string to ``MongoClient.create()`` to connect
+to a MongoDB instance:
+
+.. literalinclude:: /includes/connect/mongoclient2.kt
+   :start-after: start-connect-to-atlas-w-uri
+   :end-before: end-connect-to-atlas-w-uri
+   :language: kotlin
+   :copyable:
+   :dedent:
+
+You can also create a client with your desired configurations by passing a 
 ``MongoClientSettings`` object to the ``MongoClient.create()`` method.
 
 To instantiate a ``MongoClientSettings`` object, use the builder method to 

source/includes/connect/mongoclient.kt

@@ -6,9 +6,12 @@ import org.bson.Document
 fun main() {
 
     // start-connect-to-atlas
+    // start-connect-to-atlas-w-uri
     // Replace the placeholder with your Atlas connection string
     val uri = "<connection string>"
-
+    val mongoClient1 = MongoClient.create(uri)
+    // end-connect-to-atlas-w-uri
+    
     // Construct a ServerApi instance using the ServerApi.builder() method
     val serverApi = ServerApi.builder()
         .version(ServerApiVersion.V1)

source/includes/connect/mongoclient2.kt

@@ -0,0 +1,23 @@
+import com.mongodb.*
+import com.mongodb.kotlin.client.MongoClient
+
+fun main() {
+    
+    // start-connect-to-atlas-w-uri
+    // Replace the placeholder with your Atlas connection string
+    val uri = "<connection string>"
+
+    // Create a new client and connect to the server
+    val mongoClient = MongoClient.create(uri)
+    val database = mongoClient.getDatabase("sample_mflix")
+    // end-connect-to-atlas-w-uri
+
+    try {
+        // Send a ping to confirm a successful connection
+        val command = Document("ping", BsonInt64(1))
+        val commandResult = database.runCommand(command)
+        println("Pinged your deployment. You successfully connected to MongoDB!")
+    } catch (me: MongoException) {
+        System.err.println(me)
+    }
+}