Respond to CC feedback on #238 (#239)

* expand code intro

* fixes

* link and wording fixes

* collaborated changes

* edits

Author: rustagir

source/fundamentals/connection.txt

@@ -19,10 +19,13 @@ deployment using the Go Driver.
 Connection URI
 --------------
 
-The **connection URI** provides a set of instructions that the driver uses to
-connect to a MongoDB deployment. It instructs the driver on how it should
-connect to MongoDB and how it should behave while connected. The following
-example explains each part of a sample connection URI:
+A **connection URI**, also known as a connection string, tells the
+driver how to connect to MongoDB and how to behave while connected.
+
+Parts of a Connection URI
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following example explains each part of a sample connection URI:
 
 .. figure:: /includes/figures/connection_uri_parts.png
    :alt: Each part of the connection string
@@ -55,10 +58,31 @@ options. In the example, we set two connection options:
 ``maxPoolSize=20`` and ``w=majority``. To learn more about connection
 options, read the :ref:`golang-connection-options` section of this guide.
 
-The following code shows how you can use a connection string in a
-client to connect to MongoDB. In this example, the client uses 
-the :ref:`Stable API <golang-stable-api>` feature, though
-you can connect to MongoDB without this feature.
+Connection Example
+~~~~~~~~~~~~~~~~~~
+
+To connect to MongoDB, you need to create a client. A client manages
+your connections and runs database commands.
+
+You can create a client that uses your connection string and other
+client options by passing a ``ClientOptions`` object to the ``Connect()``
+method. To specify your connection URI, pass it to the ``ApplyURI()``
+method, creating a ``ClientOptions`` instance. To set any other
+options, call the relevant helper method from the ``options`` package.
+
+To learn more about connection options, see the
+:ref:`Connection Options section <golang-connection-options>`. To learn
+more about creating a client, see the API documentation for `Client
+<{+api+}/mongo#Client>`__ and `Connect() <{+api+}/mongo#Connect>`__.
+
+You can set the {+stable-api+} version as an option to avoid
+breaking changes when you upgrade to a new server version. To 
+learn more about the {+stable-api+} feature, see the :ref:`{+stable-api+} page
+<golang-stable-api>`.
+
+The following code shows how you can create a client that uses your
+connection string and the {+stable-api+} version, connect to MongoDB, and
+verify that the connection is successful:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/srv.go
    :language: go

source/includes/fundamentals/code-snippets/srv.go

@@ -14,6 +14,7 @@ const uri = "<connection string>"
 
 func main() {
 
+	// Use the SetServerAPIOptions() method to set the Stable API version to 1
 	serverAPI := options.ServerAPI(options.ServerAPIVersion1)
 	opts := options.Client().ApplyURI(uri).SetServerAPIOptions(serverAPI)
 
@@ -29,10 +30,10 @@ func main() {
 		}
 	}()
 
-	// Ping the primary
+	// Send a ping to confirm a successful connection
 	if err := client.Ping(context.TODO(), readpref.Primary()); err != nil {
 		panic(err)
 	}
 
-	fmt.Println("Successfully connected and pinged.")
+	fmt.Println("Pinged the primary node of the cluster. You successfully connected to MongoDB!")
 }