fixes

Author: mongoKart

snooty.toml

@@ -11,7 +11,10 @@ toc_landing_pages = [
     "/security/authentication",
     "/aggregation-tutorials",
     "/data-formats",
-    "/connect/connection-options"
+    "/connect/connection-options",
+    "crud",
+    "/crud/query",
+    "/crud/update"
 ]
 
 intersphinx = [

source/connect/connection-options.txt

@@ -113,26 +113,9 @@ Network Compression
        | **MongoClient Example**: ``zlibCompressionLevel = 3``
        | **Connection URI Example**: ``zlibCompressionLevel=3``
 
-Timeouts
-~~~~~~~~
+For more information about network compression in {+driver-short+}, see
+:ref:`<pymongo-network-compression>`.
 
-.. list-table::
-   :header-rows: 1
-   :widths: 30 70
-
-   * - Connection Option
-     - Description
-     
-   * - ``timeoutMS``
-     - | The number of milliseconds each driver operation must complete within. If an
-       | operation doesn't finish in the specified time, {+driver-short+} raises a timeout exception.
-       | For more information, see :ref:`<pymongo-csot>`.
-       |
-       | **Data Type**: ``int``
-       | **Default**: ``None``
-       | **MongoClient Example**: ``timeoutMS = 10000``
-       | **Connection URI Example**: ``timeoutMs=10000``
-       
 Server Selection
 ~~~~~~~~~~~~~~~~
 
@@ -153,6 +136,50 @@ Server Selection
        | **MongoClient Example**: ``server_selector = your_function``
        | **Connection URI Example**: N/A
 
+Stable API
+~~~~~~~~~~
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Connection Option
+     - Description
+
+   * - ``server_api``
+     - | A ``ServerApi`` object that specifies the Stable API version and other Stable API
+       | options.
+       |
+       | **Data Type**: ``ServerApi``
+       | **Default**: ``None``
+       | **MongoClient Example**: ``server_api = ServerApi("1")``
+       | **Connection URI Example**: N/A
+
+For more information about the Stable API, see :ref:`<pymongo-stable-api>`.
+
+Timeouts
+~~~~~~~~
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Connection Option
+     - Description
+     
+   * - ``timeoutMS``
+     - | The number of milliseconds each driver operation must complete within. If an
+       | operation doesn't finish in the specified time, {+driver-short+} raises a timeout exception.
+       | For more information, see :ref:`<pymongo-csot>`.
+       |
+       | **Data Type**: ``int``
+       | **Default**: ``None``
+       | **MongoClient Example**: ``timeoutMS = 10000``
+       | **Connection URI Example**: ``timeoutMs=10000``
+       
+For more information about using timeouts to limit server execution time, see
+:ref:`<pymongo-csot>`.
+
 Connection Pools
 ~~~~~~~~~~~~~~~~
 
@@ -293,7 +320,7 @@ Authentication
        | **MongoClient Example**: ``password = "strong password"``
        | **Connection URI Example**: ``password=strong+password``
 
-For more information about the connection option in this section, see :ref:`pymongo-auth`. 
+For more information about the connection options in this section, see :ref:`pymongo-auth`. 
 
 Read and Write Operations
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -376,4 +403,5 @@ Read and Write Operations
        | **MongoClient Example**: ``retryWrites=False``
        | **Connection URI Example**: ``retryWrites=false``
 
-For more information about the connection options in this section, see :ref:`pymongo-databases-collections`. 
+For more information about the connection options in this section, see
+:ref:`pymongo-configure-crud`. 

source/crud/query/cursors.txt

@@ -35,7 +35,8 @@ Sample Data
 
 The examples in this guide use the ``sample_restaurants.restaurants`` collection
 from the :atlas:`Atlas sample datasets </sample-data>`. To learn how to create a
-free MongoDB Atlas cluster and load the sample datasets, see the :ref:`<pymongo-get-started>`.
+free MongoDB Atlas cluster and load the sample datasets, see the :ref:`<pymongo-get-started>`
+tutorial.
 
 .. _pymongo-cursors-iterate:
 

source/crud/query/find.txt

@@ -36,7 +36,8 @@ Sample Data
 
 The examples in this guide use the ``sample_restaurants.restaurants`` collection
 from the :atlas:`Atlas sample datasets </sample-data>`. To learn how to create a
-free MongoDB Atlas cluster and load the sample datasets, see the :ref:`<pymongo-get-started>`.
+free MongoDB Atlas cluster and load the sample datasets, see the :ref:`<pymongo-get-started>`
+tutorial.
 
 .. _pymongo-retrieve-find:
 

source/crud/query/specify-documents-to-return.txt

@@ -32,7 +32,8 @@ Sample Data
 
 The examples in this guide use the ``sample_restaurants.restaurants`` collection
 from the :atlas:`Atlas sample datasets </sample-data>`. To learn how to create a
-free MongoDB Atlas cluster and load the sample datasets, see the :ref:`<pymongo-get-started>`.
+free MongoDB Atlas cluster and load the sample datasets, see the :ref:`<pymongo-get-started>`
+tutorial.
 
 Limit
 -----

source/data-formats.txt

@@ -26,7 +26,7 @@ Specialized Data Formats
    Custom Types </data-formats/custom-types>
    Dates & Times </data-formats/dates-and-times>
    UUIDs </data-formats/uuid>
-   Time Series </data-formats/time-series>
+   Time Series Data </data-formats/time-series>
 
 Overview
 --------

source/data-formats/custom-types/serialization.txt

@@ -20,27 +20,14 @@ Serialization
 Overview
 --------
 
-In this guide, you can learn how to use {+driver-short+} to perform
-serialization.
+In this guide, you can learn how to use {+driver-short+} to serialize your custom types.
 
 Serialization is the process of mapping a {+language+} object to a BSON
 document for storage in MongoDB. {+driver-short+} automatically converts basic {+language+}
 types into BSON when you insert a document into a collection. Similarly, when you retrieve a
 document from a collection, {+driver-short+} automatically converts the returned BSON
 back into the corresponding {+language+} types.
 
-You can use {+driver-short+} to serialize and deserialize the following {+language+}
-types:
-
-- ``str``
-- ``int``
-- ``float``
-- ``bool``
-- ``datetime.datetime``
-- ``list``
-- ``dict``
-- ``None``
-
 For a complete list of {+language+}-to-BSON mappings, see the `bson <{+api-root+}bson/index.html>`__
 API documentation.
 

source/index.txt

@@ -87,18 +87,32 @@ Atlas Search
 Learn how to use Atlas Search to build full-text search capabilities in the
 `Atlas Search tutorial <https://www.mongodb.com/docs/atlas/atlas-search/tutorial/>`__.
 
-Secure Your Data
-----------------
+Atlas Vector Search
+-------------------
 
-Learn about ways you can authenticate your application and encrypt your data in
-the :ref:`pymongo-security` section.
+Learn how to use Atlas Vector Search to query your Atlas data based on semantic meaning
+rather than keyword matches in the
+`Atlas Vector Search <https://www.mongodb.com/docs/atlas/atlas-search/tutorial/>`__
+documentation.
 
 Monitoring and Logging
 ----------------------
 
 Learn how to monitor changes to your application and write them to logs in the
 :ref:`pymongo-monitoring-logging` section.
 
+Secure Your Data
+----------------
+
+Learn about ways you can authenticate your application and encrypt your data in
+the :ref:`pymongo-security` section.
+
+Reference
+---------
+
+Find more information about {+driver-short+} versions, compatibility, and third-party tools
+in the the :ref:`pymongo-reference` section.
+
 API Documentation
 -----------------
 
@@ -109,6 +123,4 @@ Issues & Help
 -------------
 
 Learn how to report bugs, contribute to the driver, and find help in the
-:ref:`<pymongo-issues-help>` section.
-
-
+:ref:`<pymongo-issues-help>` section.

source/reference.txt

@@ -12,5 +12,5 @@ Reference
    Compatibility </reference/compatibility>
    Third-Party Tools </reference/third-party-tools>
    Upgrade Guides </reference/upgrade>
-   Migration Guides </reference/migration>
+   Migrate to PyMongo Async </reference/migration>
    Previous Versions </reference/previous-versions>

source/reference/migration.txt

@@ -72,12 +72,12 @@ The following Motor method signatures behave differently in the {+driver-async+}
 
 .. _pymongo-to-async-guide:
 
-Switch from {+driver-short+}
-----------------------------
+Migrate from {+driver-short+}
+-----------------------------
 
 The {+driver-async+} driver behaves similarly to {+driver-short+}, but
 all methods that perform network operations are coroutines and must be awaited.
-To switch from {+driver-short+} to {+driver-async+}, you must update your code
+To migrate from {+driver-short+} to {+driver-async+}, you must update your code
 in the following ways:
 
 - Replace all uses of ``MongoClient`` with ``AsyncMongoClient``.