DOCSP-36989 Count (#16)

Author: jordan-smith721

source/fundamentals/crud/count.txt

@@ -1,16 +1,43 @@
 .. uses tutorial.rst
 
-If we just want to know how many documents match a query we can
-perform a the ``~pymongo.collection.Collection.count_documents`` method operation
-instead of a full query. We can get a count of all of the documents
-in a collection:
+.. _pymongo-count:
+
+=====
+Count
+=====
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: number, amount
+
+To see how many documents are in a collection, use the
+``~pymongo.collection.Collection.count_documents()`` method.
+
+Count All Documents
+-------------------
+
+To return a count of all documents in the collection, pass an empty object to
+the ``count_documents()`` method, as shown in the following example:
 
 .. code-block:: python
 
    >> posts.count_documents({})
    3
 
-or just of those documents that match a specific query:
+Count Specific Documents
+------------------------
+
+To return a count of documents that match specific search criteria, specify a
+query in the ``count_documents()`` method, as shown in the following example:
 
 .. code-block:: python