MW Proofreading edits (#59)

Author: rustagir

source/fundamentals/aggregation.txt

@@ -13,7 +13,7 @@ Aggregation
 Overview
 --------
 
-In this guide, you can learn how to perform **aggregation operations** in
+In this guide, you can learn how to perform aggregation operations in
 the {+driver-short+}.
 
 Aggregation operations process data in your MongoDB collections based on

source/fundamentals/authentication.txt

@@ -13,8 +13,8 @@ Authentication Mechanisms
 Overview
 --------
 
-In this guide, you can learn how to use the **authentication
-mechanisms** available in the MongoDB Community Edition. When you connect
+In this guide, you can learn how to use the authentication
+mechanisms available in the MongoDB Community Edition. When you connect
 to MongoDB, you can use an authentication mechanism to establish trust
 between the driver and the server.
 
@@ -162,11 +162,11 @@ The driver obtains the credentials only from the first source in which
 they are found. The driver checks for your credentials from the following
 sources in the following order:
 
-1. ``Credential`` struct or connection string
-#. Environment variables
-#. Web identity token file
+1. ``Credential`` struct or connection string.
+#. Environment variables.
+#. Web identity token file.
 #. AWS ECS endpoint specified in the ``AWS_CONTAINER_CREDENTIALS_RELATIVE_URI``
-   environment variable
+   environment variable.
 #. AWS EC2 endpoint. For more information, see `IAM Roles for Tasks
    <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html>`__
    in the AWS documentation.
@@ -275,11 +275,6 @@ The ``MONGODB-X509`` authentication mechanism uses Transport Level Security (TLS
 with X.509 certificates to authenticate your user, which is identified
 by the relative distinguished names (RDNs) of your client certificate.
 
-.. tip::
-   
-   To learn more about TLS, see the Wikipedia entry on
-   :wikipedia:`Transport Layer Security <w/index.php?title=Transport_Layer_Security&oldid=1172659512>`.
-
 When you specify this authentication mechanism, the server authenticates
 the connection by reading the following files:
 

source/fundamentals/connections.txt

@@ -23,8 +23,8 @@ Connections
 Overview
 --------
 
-Learn how to configure your application's connection to a MongoDB
-deployment using the {+driver-short+} in the following sections:
+Learn how to use the {+driver-short+} to configure your application's
+connection to a MongoDB deployment in the following sections:
 
 - :ref:`Connection Guide <rust-connect-to-mongodb>`
 - :ref:`Connection Options <rust-connection-options>`

source/fundamentals/connections/connection-guide.txt

@@ -84,19 +84,22 @@ options. In the example, we set two connection options:
 MongoDB Client
 --------------
 
-To connect to MongoDB, you need to create a ``Client`` instance. A
+To connect to MongoDB, you must create a ``Client`` instance. A
 client manages your connections and runs database commands.
 
 .. tip:: Reuse Your Client
 
-   We recommend that you reuse your client across sessions and operations.
+   You can improve performance by reusing your client across sessions and operations.
    You can use the same ``Client`` instance to perform multiple tasks, instead of
    creating a new one each time. The ``Client`` type is safe for
    concurrent use by multiple threads or async tasks.
 
    .. TODO To learn more about how connection pools work in the driver, see
    .. the :ref:`FAQ page <rust-faq-connection-pool>`.
 
+Client Creation Methods
+~~~~~~~~~~~~~~~~~~~~~~~
+
 You can create a client that uses your connection string and other
 client options by passing a ``ClientOptions`` object to the ``with_options()``
 method.
@@ -111,11 +114,13 @@ connection string to the ``Client::with_uri_str()`` method.
 To learn more about creating a client, see the API documentation for `Client
 <{+api+}/struct.Client.html>`__ and `with_options() <{+api+}/struct.Client.html#method.with_options>`__.
 
-You can set the {+stable-api+} version as an option to avoid
-breaking changes when you upgrade to a new server version.
+.. tip:: Stable API
 
-To learn more about the {+stable-api+} feature, see the
-:ref:`{+stable-api+} <rust-stable-api>` guide.
+   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+} <rust-stable-api>` guide.
 
 .. _rust-atlas-connection-example:
 
@@ -125,21 +130,21 @@ Connection Example
 The following code shows how you can create a client that uses an Atlas
 connection string and the {+stable-api+} version, connect to MongoDB, and
 verify that the connection is successful. Select from the
-:guilabel:`Sync` or :guilabel:`Async` tabs below for corresponding
+:guilabel:`Asynchronous API` or :guilabel:`Synchronous API` tabs below for corresponding
 connection code samples.
 
 .. TODO To learn more about asynchronous and synchronous runtimes, see the
 .. :ref:`Runtimes <link>` guide.
 
 .. tabs::
 
-   .. tab:: Async
+   .. tab:: Asynchronous API
       :tabid: rust-async
 
       .. literalinclude:: /includes/fundamentals/code-snippets/connection-async.rs
          :language: rust
 
-   .. tab:: Sync
+   .. tab:: Synchronous API
       :tabid: rust-sync
 
       .. literalinclude:: /includes/fundamentals/code-snippets/connection-sync.rs
@@ -162,7 +167,7 @@ connection code samples.
 Other Ways to Connect to MongoDB
 --------------------------------
 
-If you need to connect to a single MongoDB server instance or replica set
+If you must connect to a single MongoDB server instance or replica set
 that is not hosted on Atlas, see the following sections to find out how to
 connect.
 
@@ -202,9 +207,9 @@ When connecting to a replica set, the driver takes the following actions by defa
 
 .. tip::
 
-   You only need to specify one host to connect to a replica set.
+   You are only required to specify one host to connect to a replica set.
    However, to ensure connectivity when the specified host
-   is unavailable, you should provide the full list of hosts.
+   is unavailable, provide the full list of hosts.
 
 Direct Connection
 `````````````````

source/fundamentals/connections/connection-options.txt

@@ -220,7 +220,7 @@ connected to the server.
      - Integer between -1 and 9 (inclusive)
      - ``-1``
      - | Specifies the level field of the ``zlib`` compression if you use that compressor.
-       | Setting a value of``-1`` selects the default compression level (``6``).
+       | Setting a value of ``-1`` selects the default compression level (``6``).
        | Setting a value of ``0`` specifies no compression, and setting
          a value of ``9`` specifies maximum compression.
        | To learn more about network compression, see the :ref:`rust-network-compression` guide.

source/fundamentals/connections/network-compression.txt

@@ -149,8 +149,26 @@ possible values:
 - ``Compressor::Zlib { level: <integer> }``
 
 For the compressors that have a ``level`` field, set the value to
-``None`` to indicate the default level. A higher ``level`` value
-results in more compression, which is slower.
+``None`` to indicate the default level. The following table describes the
+default and accepted compression levels for Zlib and Zstandard:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 30 40
+
+   * - Compressor
+     - Default Level
+     - Accepted Levels
+
+   * - Zlib
+     - ``6``
+     - Integers from ``0`` to ``9`` or ``None``
+
+   * - Zstandard
+     - ``3``
+     - Integers from ``1`` to ``22`` or ``None``
+
+A higher ``level`` value results in more compression, which is slower.
 
 The following example shows how to specify Snappy, Zlib, and
 Zstandard as the compressors for a connection: