DOCSP-43495 Jason edits

Author: ltran-mdb2

source/copilot-schema.txt

@@ -12,46 +12,79 @@
    :depth: 1
 
 The ``/schema`` command provides information about your collection
-schema. The |copilot| accesses your connected MongoDB deployment to
-provide schema information in the Copilot generated response. 
+schema by accessing your connected MongoDB deployment.
 
 Examples
 --------
 
 Provide a Sample Document
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Consider the ``users`` collection in the `Mflix Sample Database
+This example uses the ``users`` collection in the `Mflix Sample Database
 <https://www.mongodb.com/docs/atlas/sample-data/sample-mflix/#sample_mflix.users>`__.
+Each document in the collection has the following structure:
+
+.. code-block:: none
+   :copyable: false
+
+   {
+      "_id": {
+         "$oid": "59b99db4cfa9a34dcd7885b6"
+      },
+      "name": "Ned Stark",
+      "email": "[email protected]",
+      "password": "$2b$12$UREFwsRUoyF0CRqGNK0LzO0HM/jLhgUCNNIJ9RJAqMUQ74crlJ1Vu"
+   }
+
+
 If you are connected to a MongoDB deployment that contains this
-collection, you can ask the |copilot| to provide a sample document:
+collection, you can ask the |copilot| to show the schema of your collection:
 
 .. code-block:: none
    :copyable: false
 
-   @MongoDB /schema Can you show a sample document from the
+   @MongoDB /schema @MongoDB /schema Can you show the schema for the
    sample_mflix.users collection?
 
 GitHub Copilot uses the |copilot| to generate the following response:
 
 .. code-block:: none
    :copyable: false
 
-   Sure, here is a sample document from the sample_mflix.users
-   collection:
-   
+   The schema for the sample_mflix.users collection, based on 100
+   sampled documents, is as follows:
+
    {
       "_id": {
-         "$oid": "5f8473b823bca94021aa1c45"
+         "type": "ObjectId",
+         "probability": 1
+      },
+      "email": {
+         "type": "String",
+         "probability": 1
       },
-      "email": "[email protected]",
-      "name": "John Doe",
-      "password": "password123",
-      "preferences": {}
+      "name": {
+         "type": "String",
+         "probability": 1
+      },
+      "password": {
+         "type": "String",
+         "probability": 1
+      },
+      "preferences": {
+         "type": ["Document", "Undefined"],
+         "probability": 0.01
+      }
    }
 
-Once Copilot generates the response, you can open the JSON output to see
-more information. 
+   Key Points:
+
+   - Fields _id, email, name, and password appear in all documents with
+     a probability of 1.
+   - The preferences field is mostly undefined but occasionally contains
+     a document (1% probability).   
+
+After Copilot generates the response, you can open the output in JSON format.
 
 .. figure:: /images/copilot-schema.png
    :figwidth: 600px