DOCSP-37420 - Schemas (#6)

Author: mongoKart

source/schemas.txt

@@ -4,13 +4,20 @@
 Schema Examples
 ===============
 
-The following are a few examples of usage of PyMongoArrow Schemas in common situations.
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta::
+   :keywords: pandas, numpy, flatten
 
+This guide shows examples of how to use PyMongoArrow schemas in common situations.
 
-Nested Data With Schema
+Nested Data with Schema
 -----------------------
 
-With aggregate or find methods, you can provide a schema for nested data using the struct object. Note that there can be conflicting
+When performing aggregate or find operations, you can provide a schema for nested data
+by using the ``struct`` object. There can be conflicting
 names in sub-documents compared to their parent documents.
 
 .. code-block:: python
@@ -40,9 +47,9 @@ names in sub-documents compared to their parent documents.
      -- child 0 type: int32
    [0,10]]
 
-For Pandas and NumPy you can do the same exact thing:
+You can do the same thing when using Pandas and NumPy:
 
-.. code-block:: pycon
+.. code-block:: python
 
    >>> df = find_pandas_all(
    ...     coll, {}, schema=Schema({"start": str, "prop": struct([field("start", int32())])})
@@ -52,14 +59,14 @@ For Pandas and NumPy you can do the same exact thing:
    0  string   {'start': 0}
    1  string  {'start': 10}
 
-
-Nested Data With Projections
+Nested Data with Projections
 ----------------------------
 
-One can also use projections to flatten the data prior to ingesting into PyMongoArrow.
-The following example illustrates how to do it with a very simple nested document structure.
+You can also use projections to flatten the data before passing it to {+driver-short+}.
+The following example illustrates how to do this by using a very simple nested document
+structure:
 
-.. code-block:: pycon
+.. code-block:: python
 
    >>> df = find_pandas_all(
    ...     coll,
@@ -77,8 +84,8 @@ The following example illustrates how to do it with a very simple nested documen
    0  b'c\xec2\x98R(\xc9\x1e@#\xcc\xbb'          0      foo
    1  b'c\xec2\x98R(\xc9\x1e@#\xcc\xbc'         10      bar
 
-
-For aggregate you can flatten the fields using the ``$project`` stage, like so:
+When performing an aggregate operation, you can flatten the fields by using the ``$project``
+stage, as shown in the following example:
 
 .. code-block:: pycon