DOCSP-31521: V2 cleanup (#85)

(cherry picked from commit 119be2e)

Author: norareidy

source/fundamentals/aggregation.txt

@@ -4,6 +4,13 @@
 Aggregation
 ===========
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: pipeline, code example 
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -254,7 +261,7 @@ Retrieve Data guide.
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about any of the methods or types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `aggregate() <{+api+}/struct.Collection.html#method.aggregate>`__

source/fundamentals/authentication.txt

@@ -4,6 +4,13 @@
 Authentication Mechanisms
 =========================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: validate credentials, protocols, code example 
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -315,7 +322,7 @@ To learn more about managing users of your MongoDB deployment, see
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about the methods and types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `Credential <{+api+}/options/struct.Credential.html>`__

source/fundamentals/connections/connection-guide.txt

@@ -4,6 +4,13 @@
 Connection Guide
 ================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: access deployment, code example, authentication
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -133,8 +140,10 @@ verify that the connection is successful. Select from the
 :guilabel:`Asynchronous API` or :guilabel:`Synchronous API` tabs below for corresponding
 connection code samples.
 
-.. TODO To learn more about asynchronous and synchronous runtimes, see the
-.. :ref:`Runtimes <link>` guide.
+.. tip::
+
+   To learn more about asynchronous and synchronous runtimes, see the
+   :ref:`rust-runtimes` guide.
 
 .. tabs::
 

source/fundamentals/crud/compound-operations.txt

@@ -4,6 +4,13 @@
 Compound Operations
 ===================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: write lock, code example
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -135,7 +142,8 @@ The following table describes the options available in
        | Type: ``WriteConcern``
 
    * - ``collation`` 
-     - | The collation to use when sorting results.
+     - | The collation to use when sorting results. To learn more about collations,
+         see the :ref:`rust-collations` guide.
        |
        | Type: ``Collation``
        | Default: ``None``
@@ -301,7 +309,8 @@ The following table describes the options available in
        | Type: ``WriteConcern``
 
    * - ``collation`` 
-     - | The collation to use when sorting results.
+     - | The collation to use when sorting results. To learn more about collations,
+         see the :ref:`rust-collations` guide.
        |
        | Type: ``Collation``
        | Default: ``None``
@@ -337,7 +346,7 @@ The following table describes the options available in
 The {+driver-short+} implements the Builder design pattern for the
 creation of a ``FindOneAndUpdateOptions`` instance. You can use the
 type's ``builder()`` method to construct an options instance by
-chaining option builder functions one at a time.
+chaining option builder methods one at a time.
 
 The following code shows how to construct a ``FindOneAndUpdateOptions``
 instance and pass it to the ``find_one_and_update()`` method:
@@ -469,7 +478,8 @@ The following table describes the options available in
        | Type: ``WriteConcern``
 
    * - ``collation`` 
-     - | The collation to use when sorting results.
+     - | The collation to use when sorting results. To learn more about collations,
+         see the :ref:`rust-collations` guide.
        |
        | Type: ``Collation``
        | Default: ``None``
@@ -564,7 +574,7 @@ following documentation:
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about the methods and types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `find_one_and_delete() <{+api+}/struct.Collection.html#method.find_one_and_delete>`__

source/fundamentals/crud/read-operations/query.txt

@@ -4,6 +4,13 @@
 Specify a Query
 ===============
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: search, compare, code example 
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -394,7 +401,7 @@ To learn more about query operators, see :manual:`Query Selectors
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about any of the methods or types used in this
+To learn more about the methods and types used in this
 guide, see the following API documentation:
 
 - `find() <{+api+}/struct.Collection.html#method.find>`__

source/fundamentals/crud/read-operations/retrieve.txt

@@ -4,6 +4,13 @@
 Retrieve Data
 =============
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: find one, find many, pipeline, code example 
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -124,7 +131,8 @@ The following table describes commonly used settings that you can specify in
      - Description
 
    * - ``collation`` 
-     - | The collation to use when sorting results.
+     - | The collation to use when sorting results. To learn more about collations,
+         see the :ref:`rust-collations` guide.
        |
        | Type: ``Collation``
        | Default: ``None``
@@ -168,7 +176,6 @@ The following table describes commonly used settings that you can specify in
        | Default: ``None``
 
 .. TODO link to projection fundamentals page under projection setting
-.. TODO link to collation fundamentals page under collations setting
 .. TODO link to skip fundamentals page under skip setting
 .. TODO link to sort fundamentals page under sort setting
 
@@ -325,7 +332,8 @@ The following table describes commonly used settings that you can specify in
          subsequent batches
 
    * - ``collation``
-     - | The collation to use when sorting results.
+     - | The collation to use when sorting results. To learn more about collations,
+         see the :ref:`rust-collations` guide.
        |
        | Type: ``Collation``
        | Default: ``None``
@@ -356,8 +364,6 @@ The following table describes commonly used settings that you can specify in
        |
        | Type: ``WriteConcern``
 
-.. TODO link to collation fundamentals page under collations setting
-
 For a full list of settings, see the API
 documentation for `AggregateOptions <{+api+}/options/struct.AggregateOptions.html>`__.
 
@@ -393,11 +399,11 @@ pipeline that contains the following stages:
 Additional Information
 ----------------------
 
-.. TODO For runnable examples of the find operations, see the following usage
-.. examples:
-.. 
-.. - :ref:`rust-find-one`
-.. - :ref:`rust-find-multiple`
+For runnable examples of the find operations, see the following usage
+examples:
+
+- :ref:`rust-find-one-usage`
+- :ref:`rust-find-usage`
 
 To learn more about the operations in this guide, see the
 following documentation:
@@ -415,7 +421,7 @@ following documentation:
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about the methods and types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `find_one() <{+api+}/struct.Collection.html#method.find_one>`__

source/fundamentals/crud/write-operations/change.txt

@@ -4,6 +4,13 @@
 Modify Documents
 ================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: update one, update many, set options, code example 
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -437,7 +444,8 @@ The following table describes the options available in ``UpdateOptions``:
        | Type: ``bool``
 
    * - ``collation`` 
-     - | The collation to use when sorting results.
+     - | The collation to use when sorting results. To learn more about collations,
+         see the :ref:`rust-collations` guide.
        |
        | Type: ``Collation``
        | Default: ``None``
@@ -497,12 +505,12 @@ documentation:
 - :ref:`rust-query-guide` guide
 - :ref:`rust-compound-operations` guide
 
-.. TODO For runnable examples of the update and replace operations, see the
-.. following usage examples:
-.. 
-.. - :ref:`rust-update-one`
-.. - :ref:`rust-update-many`
-.. - :ref:`rust-replace`
+For runnable examples of the update and replace operations, see the
+following usage examples:
+
+- :ref:`rust-update-one-usage`
+- :ref:`rust-update-many-usage`
+- :ref:`rust-replace-usage`
 
 To learn more about the update operators, see :manual:`Update Operators
 </reference/operator/update/#update-operators>` in the Server manual.
@@ -514,7 +522,7 @@ To learn more about the update operators, see :manual:`Update Operators
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about any of the methods or types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `update_one() <{+api+}/struct.Collection.html#method.update_one>`__

source/fundamentals/crud/write-operations/delete.txt

@@ -4,6 +4,13 @@
 Delete Documents
 ================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: set options, code example 
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -82,7 +89,8 @@ The following table describes settings that you can specify in a
      - Description
 
    * - ``collation`` 
-     - | The collation to use when sorting results.
+     - | The collation to use when sorting results. To learn more about collations,
+         see the :ref:`rust-collations` guide.
        |
        | Type: ``Collation``
        | Default: ``None``
@@ -178,24 +186,24 @@ following parameters:
 Additional Information
 ----------------------
 
-.. TODO For runnable examples of the delete operations, see the following usage
-.. examples:
+For runnable examples of the delete operations, see the following usage
+examples:
 
-.. - :ref:`rust-delete-one`
-.. - :ref:`rust-delete-many`
+- :ref:`rust-delete-one-usage`
+- :ref:`rust-delete-many-usage`
 
 To learn more about the operations in this guide, see the
 following documentation:
 
 - :ref:`rust-query-guide` guide
+- :ref:`rust-collations` guide
 
 .. - :ref:`rust-indexes`.
-.. - :ref:`rust-collations`.
 
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about any of the methods or types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `delete_one() <{+api+}/struct.Collection.html#method.delete_one>`__

source/fundamentals/crud/write-operations/insert.txt

@@ -4,6 +4,13 @@
 Insert Documents
 ================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: set options, bulk write error, code example
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -318,13 +325,16 @@ still find the non-error-producing documents in your collection:
 Additional Information
 ----------------------
 
-.. TODO For runnable examples of the insert operations, see the following usage
-.. examples:
+For runnable examples of the insert operations, see the following usage
+examples:
+
+- :ref:`rust-insert-one-usage`
+- :ref:`rust-insert-many-usage`
 
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about any of the methods or types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `insert_one() <{+api+}/struct.Collection.html#method.insert_one>`__

source/fundamentals/enterprise-auth.txt

@@ -4,6 +4,13 @@
 Enterprise Authentication Mechanisms
 ====================================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: enterprise edition, verify credentials, code example
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -115,7 +122,7 @@ To learn more about the concepts in this guide, see the following documentation:
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-To learn more about the methods and types discussed in this
+To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `Credential <{+api+}/options/struct.Credential.html>`__