Merge remote-tracking branch 'upstream/master' into docsp-46362-toc-reorg

Author: mongoKart

snooty.toml

@@ -1,5 +1,5 @@
 name = "pymongo"
-title = "PyMongo"
+title = "PyMongo Driver"
 toc_landing_pages = [
     "/get-started",
     "/connect",

source/data-formats/bson.txt

@@ -107,10 +107,10 @@ The following example reads the sample BSON document from ``file.bson``:
    .. input::
       :language: python
 
-         with open("file.bson", "rb") as file:
-             data = file.read()
-             document = bson.decode(data)
-             print(document)
+      with open("file.bson", "rb") as file:
+          data = file.read()
+          document = bson.decode(data)
+          print(document)
 
    .. output::
       :visible: false
@@ -140,25 +140,53 @@ constructor to ``RawBSONDocument``.
    first convert it to a {+language+} dictionary.
 
 The following example configures a ``MongoClient`` object to use ``RawBSONDocument`` objects
-to model the collection, then retrieves the sample document from the preceding examples:
+to model the collection, then retrieves the sample document from the preceding examples.
+Select the :guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding
+code.
 
-.. io-code-block::
-   :copyable: true
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
 
-   .. input::
-      :language: python
-      
-      from bson.raw_bson import RawBSONDocument
+      .. io-code-block::
+         :copyable: true
 
-      client = pymongo.MongoClient("<connection URI>", document_class=RawBSONDocument)
-      collection = client.sample_restaurants.restaurants
-      raw_doc = collection.find_one({"name": "Mongo's Pizza"})
-      print(type(raw_doc))
+         .. input::
+            :language: python
+            
+            from bson.raw_bson import RawBSONDocument
 
-   .. output::
-      :visible: false
+            client = pymongo.MongoClient("<connection URI>", document_class=RawBSONDocument)
+            collection = client.sample_restaurants.restaurants
+            raw_doc = collection.find_one({"name": "Mongo's Pizza"})
+            print(type(raw_doc))
+
+         .. output::
+            :visible: false
+
+            <class 'bson.raw_bson.RawBSONDocument'>
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. io-code-block::
+         :copyable: true
+
+         .. input::
+            :language: python
+            
+            from bson.raw_bson import RawBSONDocument
+
+            client = pymongo.AsyncMongoClient("<connection URI>", document_class=RawBSONDocument)
+            collection = client.sample_restaurants.restaurants
+            raw_doc = await collection.find_one({"name": "Mongo's Pizza"})
+            print(type(raw_doc))
+
+         .. output::
+            :visible: false
 
-      <class 'bson.raw_bson.RawBSONDocument'>
+            <class 'bson.raw_bson.RawBSONDocument'>
 
 API Documentation
 -----------------

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

@@ -52,11 +52,17 @@ serialized object into a collection:
            self.name = name
            self.cuisine = cuisine
 
-   restaurant = Guitar("Example Cafe", "Coffee")
+   restaurant = Restaurant("Example Cafe", "Coffee")
    restaurant_dict = vars(restaurant)
 
    collection.insert_one(restaurant_dict)
 
+The preceding example serializes the ``Restaurant`` object into the following dictionary:
+
+.. code-block:: none
+
+   {'name': 'Example Cafe', 'cuisine': 'Coffee'}
+
 To learn more about inserting documents into a collection, see the :ref:`pymongo-write-insert`
 guide.