RR feedback

Author: mcmorisi

source/indexes.txt

@@ -1,8 +1,8 @@
 .. _kotlin-sync-indexes:
 
-=============================
-Optimize Queries with Indexes
-=============================
+=================================
+Optimize Queries by Using Indexes
+=================================
 
 .. contents:: On this page
    :local:
@@ -15,7 +15,7 @@ Optimize Queries with Indexes
    :values: reference
 
 .. meta::
-   :description: Learn how to use indexes with the MongoDB {+driver-short+} driver.
+   :description: Learn how to use indexes by using the MongoDB Kotlin Sync driver.
    :keywords: query, optimization, efficiency, usage example, code example
 
 .. TODO
@@ -28,8 +28,8 @@ Optimize Queries with Indexes
 Overview
 --------
 
-On this page, you can see copyable code examples that show how to work with common
-types of indexes that you can use with the {+driver-short+}.
+On this page, you can see copyable code examples that show how to manage different
+types of indexes by using the {+driver-short+}.
 
 .. TODO
 .. .. tip::
@@ -86,8 +86,7 @@ The following example creates a compound index on the specified fields:
 Multikey Index
 --------------
 
-The following example creates a multikey index on the specified field that contains
-array values:
+The following example creates a multikey index on the specified array-valued field:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
    :start-after: start-multikey
@@ -99,150 +98,154 @@ array values:
 .. TODO To learn more about multikey indexes, see the :ref:`kotlin-sync-multikey-index`
 .. guide.
 
-Atlas Search Index
-------------------
-
-.. TODO: To learn more about Atlas search indexes, see the :ref:`kotlin-sync-atlas-search-index`
-.. guide.
-
-Create Search Index
-~~~~~~~~~~~~~~~~~~~
+Geospatial Index
+----------------
 
-The following example creates an Atlas search index on the specified field:
+The following example creates a 2dsphere index on the specified field that contains
+GeoJSON objects:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-search-create
-   :end-before: end-search-create
+   :start-after: start-geo
+   :end-before: end-geo
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about creating serach indexes, see the :ref:`kotlin-sync-atlas-search-index-create`
+.. TODO: To learn more about geospatial indexes, see the :ref:`kotlin-sync-geospatial-index`
 .. guide.
 
-List Search Indexes
-~~~~~~~~~~~~~~~~~~~
+Unique Index
+------------
 
-The following example prints a list of Atlas search indexes in the specified collection:
+The following example creates a unique index on the specified field:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-search-list
-   :end-before: end-search-list
+   :start-after: start-unique
+   :end-before: end-unique
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about listing search indexes, see the :ref:`kotlin-sync-atlas-search-index-list`
+.. TODO: To learn more about unique indexes, see the :ref:`kotlin-sync-unique-index`
 .. guide.
 
-Update Search Indexes
-~~~~~~~~~~~~~~~~~~~~~
+Wildcard Index
+--------------
 
-The following example updates an existing Atlas search index:
+The following example creates a wildcard index in the specified collection:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-search-update
-   :end-before: end-search-update
+   :start-after: start-wildcard
+   :end-before: end-wildcard
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about updating search indexes, see the :ref:`kotlin-sync-atlas-search-index-update`
+.. TODO: To learn more about wildcard indexes, see the :ref:`kotlin-sync-wildcard-index`
 .. guide.
 
-Delete Search Indexes
-~~~~~~~~~~~~~~~~~~~~~
+Clustered Index
+---------------
 
-The following example deletes an Atlas search index with the specified name:
+The following example creates a new collection with a clustered index on the ``_id``
+field:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-search-delete
-   :end-before: end-search-delete
+   :start-after: start-clustered
+   :end-before: end-clustered
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about deleting search indexes, see the :ref:`kotlin-sync-atlas-search-index-drop`
+.. TODO: To learn more about wildcard indexes, see the :ref:`kotlin-sync-clustered-index`
 .. guide.
 
-Text Index
-----------
+Atlas Search Index Management
+-----------------------------
+
+The following sections contain code examples that describe how to manage Atlas Search
+indexes.
+
+.. TODO: To learn more about Atlas search indexes, see the :ref:`kotlin-sync-atlas-search-index`
+.. guide.
+
+Create Search Index
+~~~~~~~~~~~~~~~~~~~
 
-The following example creates a text index on the specified field:
+The following example creates an Atlas search index on the specified field:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-text
-   :end-before: end-text
+   :start-after: start-search-create
+   :end-before: end-search-create
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about text indexes, see the :ref:`kotlin-sync-text-index`
+.. TODO: To learn more about creating serach indexes, see the :ref:`kotlin-sync-atlas-search-index-create`
 .. guide.
 
-Geospatial Index
-----------------
+List Search Indexes
+~~~~~~~~~~~~~~~~~~~
 
-The following example creates a 2dsphere index on the specified field that contains
-GeoJSON objects:
+The following example prints a list of Atlas search indexes in the specified collection:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-geo
-   :end-before: end-geo
+   :start-after: start-search-list
+   :end-before: end-search-list
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about geospatial indexes, see the :ref:`kotlin-sync-geospatial-index`
+.. TODO: To learn more about listing search indexes, see the :ref:`kotlin-sync-atlas-search-index-list`
 .. guide.
 
-Unique Index
-------------
+Update Search Indexes
+~~~~~~~~~~~~~~~~~~~~~
 
-The following example creates a unique index on the specified field:
+The following example updates an existing Atlas search index with the specified
+new index definition:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-unique
-   :end-before: end-unique
+   :start-after: start-search-update
+   :end-before: end-search-update
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about unique indexes, see the :ref:`kotlin-sync-unique-index`
+.. TODO: To learn more about updating search indexes, see the :ref:`kotlin-sync-atlas-search-index-update`
 .. guide.
 
-Wildcard Index
---------------
+Delete Search Indexes
+~~~~~~~~~~~~~~~~~~~~~
 
-The following example creates a wildcard index in the specified collection:
+The following example deletes an Atlas search index with the specified name:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-wildcard
-   :end-before: end-wildcard
+   :start-after: start-search-delete
+   :end-before: end-search-delete
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about wildcard indexes, see the :ref:`kotlin-sync-wildcard-index`
+.. TODO: To learn more about deleting search indexes, see the :ref:`kotlin-sync-atlas-search-index-drop`
 .. guide.
 
-Clustered Index
----------------
+Text Index
+----------
 
-The following example creates a new collection with a clustered index on the ``_id``
-field:
+The following example creates a text index on the specified string field:
 
 .. literalinclude:: /includes/usage-examples/index-code-examples.kt
-   :start-after: start-clustered
-   :end-before: end-clustered
+   :start-after: start-text
+   :end-before: end-text
    :language: kotlin
    :copyable:
    :dedent:
 
-.. TODO: To learn more about wildcard indexes, see the :ref:`kotlin-sync-clustered-index`
+.. TODO: To learn more about text indexes, see the :ref:`kotlin-sync-text-index`
 .. guide.
 
-Remove an Index
+Delete an Index
 ---------------
 
 The following example deletes an index with the specified name: