RR feedback

Author: mcmorisi

source/connect.txt

@@ -72,9 +72,16 @@ code:
 Connection
 ----------
 
+The following sections describe how to connect to different targets, such as a local
+instance of MongoDB or a cloud-hosted instance on Atlas.
+
 Local Deployment
 ~~~~~~~~~~~~~~~~
 
+The following code shows how to connect  the connection string to connect to a local
+MongoDB deployment. Select the :guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to 
+see the corresponding code:
+
 .. tabs::
 
    .. tab:: Synchronous
@@ -96,6 +103,10 @@ Local Deployment
 Atlas
 ~~~~~
 
+The following code shows the connection string to connect to a deployment hosted on
+Atlas. Select the :guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the
+corresponding code:
+
 .. tabs::
 
    .. tab:: Synchronous
@@ -105,7 +116,7 @@ Atlas
 
          uri = "<Atlas connection string>"
          client = MongoClient(uri, server_api=pymongo.server_api.ServerApi(
-          version="1", strict=True, deprecation_errors=True))
+            version="1", strict=True, deprecation_errors=True))
 
    .. tab:: Asynchronous
       :tabid: async
@@ -114,11 +125,15 @@ Atlas
 
          uri = "<Atlas connection string>"
          client = AsyncMongoClient(uri, server_api=pymongo.server_api.ServerApi(
-          version="1", strict=True, deprecation_errors=True))
+            version="1", strict=True, deprecation_errors=True))
 
 Replica Set
 ~~~~~~~~~~~
 
+The following code shows the connection string to connect to a replica set. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding
+code:
+
 .. tabs::
 
    .. tab:: Synchronous
@@ -140,6 +155,9 @@ Replica Set
 Network Compression
 -------------------
 
+The following sections describe how to connect to MongoDB while specifying network
+compression algorithms.
+
 Compression Algorithms
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -151,6 +169,8 @@ To learn more about specifying compression algorithms, see
 zlib Compression Level
 ~~~~~~~~~~~~~~~~~~~~~~
 
+The following tabs demonstrate how to specify a compression level for the ``zlib`` compressor:
+
 .. tabs::
 
    .. tab:: MongoClient
@@ -159,8 +179,8 @@ zlib Compression Level
       .. code-block:: python
 
          client = pymongo.MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>",
-                                      compressors = "zlib",
-                                      zlibCompressionLevel=<zlib compression level>)
+            compressors = "zlib",
+            zlibCompressionLevel=<zlib compression level>)
 
    .. tab:: Connection String
       :tabid: connectionstring
@@ -178,17 +198,17 @@ zlib Compression Level
       .. code-block:: python
 
          client = pymongo.AsyncMongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>",
-                                           compressors = "zlib",
-                                           zlibCompressionLevel=<zlib compression level>)
+            compressors = "zlib",
+            zlibCompressionLevel=<zlib compression level>)
 
    .. tab:: Connection String (Asynchronous)
       :tabid: connectionstring-async
 
       .. code-block:: python
 
          uri = ("mongodb://<db_username>:<db_password>@<hostname>:<port>/?"
-                "compressors=zlib"
-                "zlibCompressionLevel=<zlib compression level>")
+            "compressors=zlib"
+            "zlibCompressionLevel=<zlib compression level>")
          client = pymongo.AsyncMongoClient(uri)
 
 To learn more about setting the zlib compression level, see
@@ -197,6 +217,10 @@ To learn more about setting the zlib compression level, see
 Server Selection
 ----------------
 
+The following code shows a connection string that specifies a server selection function.
+Select the :guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding
+code:
+
 .. tabs::
 
    .. tab:: Synchronous
@@ -205,22 +229,26 @@ Server Selection
       .. code-block:: python
 
          client = pymongo.MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>",
-                                      server_selector=<selector function>)
+            server_selector=<selector function>)
 
    .. tab:: Asynchronous
       :tabid: async
 
       .. code-block:: python
 
          client = pymongo.AsyncMongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>",
-                                           server_selector=<selector function>)
+            server_selector=<selector function>)
 
 To learn more about customizing server selection, see
 :ref:`pymongo-server-selection`.
 
 {+stable-api+}
 --------------
 
+The following code shows how to specify {+stable-api+} settings for a connection.Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding
+code:
+
 .. tabs::
 
    .. tab:: Synchronous
@@ -231,7 +259,7 @@ To learn more about customizing server selection, see
          from pymongo.server_api import ServerApi
 
          client = pymongo.MongoClient("mongodb://<db_username>:<db_password>@<hostname:<port>",
-                                      server_api=ServerApi("<{+stable-api+} version>"))
+            server_api=ServerApi("<{+stable-api+} version>"))
 
    .. tab:: Asynchronous
       :tabid: async
@@ -241,7 +269,7 @@ To learn more about customizing server selection, see
          from pymongo.server_api import ServerApi
 
          client = pymongo.AsyncMongoClient("mongodb://<db_username>:<db_password>@<hostname:<port>",
-                                           server_api=ServerApi("<{+stable-api+} version>"))
+            server_api=ServerApi("<{+stable-api+} version>"))
 
 To learn more about the {+stable-api+}, see :ref:`pymongo-stable-api`.
 
@@ -251,6 +279,8 @@ Limit Server Execution Time
 timeout Block
 ~~~~~~~~~~~~~
 
+The following code shows how to set a client-side timeout by using the ``timeout()`` method:
+
 .. code-block:: python
 
    with pymongo.timeout(<timeout length>):
@@ -261,6 +291,9 @@ To learn more about client-side timeouts, see :ref:`pymongo-csot`.
 timeoutMS Connection Option
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+The following tabs demonstrate how to set a client-side timeout by using the ``timeoutMS``
+connection option:
+
 .. tabs::
 
    .. tab:: MongoClient
@@ -269,7 +302,7 @@ timeoutMS Connection Option
       .. code-block:: python
 
          client = pymongo.MongoClient("mongodb://<db_username>:<db_password>@<hostname@:<port>",
-                                      timeoutMS=<timeout length>)
+            timeoutMS=<timeout length>)
 
    .. tab:: Connection String
       :tabid: connectionstring
@@ -285,7 +318,7 @@ timeoutMS Connection Option
       .. code-block:: python
 
          client = pymongo.AsyncMongoClient("mongodb://<db_username>:<db_password>@<hostname@:<port>",
-                                           timeoutMS=<timeout length>)
+            timeoutMS=<timeout length>)
 
    .. tab:: Connection String (Asynchronous)
       :tabid: connectionstring-async

source/connect/mongoclient.txt

@@ -97,7 +97,7 @@ instance on port ``27017`` of ``localhost``:
    uri = "mongodb://localhost:27017/"
    client = MongoClient(uri)
 
-If you need to use an asynchronous version of the ``MongoClient`` class, use the
+If you must use an asynchronous version of the ``MongoClient`` class, use the
 ``AsyncMongoClient`` class. The following example shows how to create an
 ``AsyncMongoClient`` object: