DOCSP-36985 network compression (#8)

Author: jordan-smith721

source/fundamentals/connection/network-compression.txt

@@ -1,60 +1,83 @@
 .. uses network-compression.rst, installation.rst
 
 .. _network-compression-example:
+.. _pymongo-network-compression:
 
+===================
 Network Compression
 ===================
 
-PyMongo supports network compression where network traffic between the client
-and MongoDB server are compressed which reduces the amount of data passed
-over the network. By default no compression is used.
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: wire protocol
+
+{+driver-short+} supports network compression, which compresses network traffic
+between the client and the MongoDB server, and reduces the amount of data passed
+over the network. By default, {+driver-short+} doesn't use any compression.
 
 The driver supports the following algorithms:
 
-- `snappy <https://pypi.org/project/python-snappy>`_ available in MongoDB 3.4 and later.
+- `snappy <https://pypi.org/project/python-snappy>`__, available in MongoDB 3.4 and later.
 - ``zlib`` available in MongoDB 3.6 and later.
-- `zstandard <https://pypi.org/project/zstandard/>`_ available in MongoDB 4.2 and later.
+- `zstandard <https://pypi.org/project/zstandard/>`__, available in MongoDB 4.2 and later.
 
 Wire protocol compression with snappy requires `python-snappy
-<https://pypi.org/project/python-snappy>`_:
+<https://pypi.org/project/python-snappy>`__:
 
 .. code-block:: python
 
-  $ python3 -m pip install "pymongo[snappy]"
+   $ python3 -m pip install "pymongo[snappy]"
 
 Wire protocol compression with zstandard requires `zstandard
-<https://pypi.org/project/zstandard>`_:
+<https://pypi.org/project/zstandard>`__:
 
 .. code-block:: python
 
-  $ python3 -m pip install "pymongo[zstd]"
+   $ python3 -m pip install "pymongo[zstd]"
+
+Specify Compression Algorithms
+------------------------------
 
-Applications can enable wire protocol compression via the ``compressors`` URI and
-keyword argument to the ``~pymongo.mongo_client.MongoClient`` method. For example:
+You can enable wire protocol compression when you're instantiating a
+``MongoClient`` by specifying the algorithm name in
+the ``compressors`` option. For example:
 
 .. code-block:: python
 
   >>> client = MongoClient(compressors='zlib')
 
-When multiple compression algorithms are given, the driver selects the first one in the
-list supported by the MongoDB instance to which it is connected. For example:
+When you specify multiple compression algorithms, the driver selects the first one in the
+list supported by the MongoDB instance it's connected to. For example:
 
 .. code-block:: python
 
-  >>> client = MongoClient(compressors='snappy,zstandard,zlib')
+   >>> client = MongoClient(compressors='snappy,zstandard,zlib')
 
-The ``compressors`` option can also be set via the URI:
+You can also set the ``compressors`` option in the connection URI:
 
 .. code-block:: python
 
-  >>> client = MongoClient('mongodb://example.com/?compressors=snappy,zstandard,zlib')
+   >>> client = MongoClient('mongodb://example.com/?compressors=snappy,zstandard,zlib')
 
-Additionally, zlib compression allows specifying a compression level with supported values from -1 to 9:
+Additionally, ``zlib`` compression allows specifying a compression level with supported values from -1 to 9:
 
 .. code-block:: python
 
-  >>> client = MongoClient(compressors='zlib', zlibCompressionLevel=-1)
+   >>> client = MongoClient(compressors='zlib', zlibCompressionLevel=-1)
+
+Pass the ``zlibCompressionLevel`` as the ``level`` argument to ``zlib.compress``.
 
-The ``zlibCompressionLevel`` is passed as the ``level`` argument to ``zlib.compress``.
+.. seealso::
 
-.. seealso:: The MongoDB documentation on `network compression URI options <https://dochub.mongodb.org/core/compression-options>`_.
+   To learn more about network compression URI options, see the
+   :manual:`Compression Options </reference/connection-string/#compression-options>` 
+   section on the Server manual.