DOCSP-48163: Add async examples for Read pages

Author: mcmorisi

source/crud/query.txt

@@ -50,81 +50,182 @@ the relevant values for your MongoDB deployment.
 
 .. include:: /includes/usage-examples/sample-app-intro.rst
 
-.. literalinclude:: /includes/usage-examples/crud-sample-app.py
-   :language: python
-   :copyable:
-   :linenos:
-   :emphasize-lines: 11-13
+Select the :guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding
+code:
+
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/crud-sample-app.py
+         :language: python
+         :copyable:
+         :linenos:
+         :emphasize-lines: 11-13
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/crud-sample-app-async.py
+         :language: python
+         :copyable:
+         :linenos:
+         :emphasize-lines: 13-15
 
 Find One
 --------
 
-.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
-   :start-after: start-find-one
-   :end-before: end-find-one
-   :language: python
-   :copyable:
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+         :start-after: start-find-one
+         :end-before: end-find-one
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples-async.py
+         :start-after: start-find-one
+         :end-before: end-find-one
 
 To learn more about the ``find_one()`` method, see :ref:`pymongo-retrieve-find-one` in
 the Retrieve Data guide.
 
 Find Multiple
 -------------
 
-.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
-   :start-after: start-find
-   :end-before: end-find
-   :language: python
-   :copyable:
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+         :start-after: start-find
+         :end-before: end-find
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples-async.py
+         :start-after: start-find
+         :end-before: end-find
 
 To learn more about the ``find()`` method, see :ref:`pymongo-retrieve-find-multiple` in
 the Retrieve Data guide.
 
 Count Documents in a Collection
 -------------------------------
 
-.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
-   :start-after: start-count-all
-   :end-before: end-count-all
-   :language: python
-   :copyable:
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+         :start-after: start-count-all
+         :end-before: end-count-all
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples-async.py
+         :start-after: start-count-all
+         :end-before: end-count-all
 
 To learn more about the ``count_documents()`` method, see the
 :ref:`pymongo-accurate-count` guide.
 
 Count Documents Returned from a Query
 -------------------------------------
 
-.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
-   :start-after: start-count-query
-   :end-before: end-count-query
-   :language: python
-   :copyable:
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+         :start-after: start-count-query
+         :end-before: end-count-query
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples-async.py
+         :start-after: start-count-query
+         :end-before: end-count-query
 
 To learn more about the ``count_documents()`` method, see the
 :ref:`pymongo-accurate-count` guide.
 
 Estimated Document Count
 ------------------------
 
-.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
-   :start-after: start-estimated-count
-   :end-before: end-estimated-count
-   :language: python
-   :copyable:
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+         :start-after: start-estimated-count
+         :end-before: end-estimated-count
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples-async.py
+         :start-after: start-estimated-count
+         :end-before: end-estimated-count
 
 To learn more about the ``estimated_document_count()`` method, see the
 :ref:`pymongo-estimated-count` guide.
 
 Retrieve Distinct Values
 ------------------------
 
-.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
-   :start-after: start-distinct
-   :end-before: end-distinct
-   :language: python
-   :copyable:
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+         :start-after: start-distinct
+         :end-before: end-distinct
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples-async.py
+         :start-after: start-distinct
+         :end-before: end-distinct
 
 To learn more about the ``distinct()`` method, see the
 :ref:`pymongo-distinct` guide.
 
+<<<<<<< HEAD:source/crud/query.txt
+=======
+Monitor Data Changes
+--------------------
+
+.. tabs::
+   
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+         :start-after: start-watch-for-changes
+         :end-before: end-watch-for-changes
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/usage-examples/retrieve-code-examples-async.py
+         :start-after: start-watch-for-changes
+         :end-before: end-watch-for-changes
+
+To learn more about the ``watch()`` method, see the
+:ref:`pymongo-change-streams` guide.
+>>>>>>> 5387503 (DOCSP-48163: Add async examples for Read pages):source/read.txt

source/crud/query/count.txt

@@ -39,21 +39,47 @@ Count All Documents
 ~~~~~~~~~~~~~~~~~~~
 
 To return a count of all documents in the collection, pass an empty dictionary to
-the ``count_documents()`` method, as shown in the following example:
+the ``count_documents()`` method, as shown in the following example. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
-.. code-block:: python
+.. tabs::
 
-   collection.count_documents({})
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. code-block:: python
+
+         collection.count_documents({})
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. code-block:: python
+
+         await collection.count_documents({})
 
 Count Specific Documents
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 To return a count of documents that match specific search criteria, specify your
-query in the ``count_documents()`` method, as shown in the following example:
+query in the ``count_documents()`` method, as shown in the following example. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
+
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. code-block:: python
 
-.. code-block:: python
-   
-   collection.count_documents({ "author": "Mike" })
+         collection.count_documents({ "author": "Mike" })
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. code-block:: python
+      
+         await collection.count_documents({ "author": "Mike" })
 
 Customize Count Behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -103,11 +129,24 @@ the ``estimated_document_count()`` method. The method estimates the amount of
 documents based on collection metadata, which might be faster than performing an 
 accurate count.
 
-The following example estimates the number of documents in a collection:
+The following example estimates the number of documents in a collection. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
+
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. code-block:: python
+
+         collection.estimated_document_count()
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. code-block:: python
 
-.. code-block:: python
-   
-   collection.estimated_document_count()
+         await collection.estimated_document_count()
 
 Customize Estimated Count Behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~