Feedback

Author: mayaraman19

source/includes/reference/indexes.rb

@@ -42,7 +42,7 @@ class Restaurant
     include Mongoid::Document
 
     field :name, type: String
-    embeds_many :addresses
+    field :borough, type: String
 
     index({borough: 1, name: -1}, { name: "compound_index"})
 end

source/reference/indexes.txt

@@ -6,6 +6,13 @@ Work With Indexes
 
 .. default-domain:: mongodb
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: code example, odm, optimization, efficiency, Atlas search
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -44,18 +51,18 @@ named ``cuisine_index`` on the ``cuisine`` field in the ``Restaurant`` class:
   :end-before: end create index
 
 The ``index`` macro defines the index you want to create and the ``create_indexes``
-macro creates the index in the ``restaurants`` collection. 
+macro creates it in the ``restaurants`` collection. 
 
 When defining an index, the first hash object contains the field you want to
-index and its direction. ``1`` represents an ascending index, ``-1`` represents a
+index and its direction. ``1`` represents an ascending index, and ``-1`` represents a
 descending index. The second hash object contains index options. To learn more
 about index options, see the :ref:`mongoid-indexes-api-documentation` section.
 
 Aliases and Declaring Indexes
 +++++++++++++++++++++++++++++
 
 You can use aliased field names in index definitions. For example, the following
-example creates a field on the ``b`` field, which is an alias of the ``borough``
+code creates a field on the ``b`` field, which is an alias of the ``borough``
 field:
 
 .. literalinclude:: /includes/reference/indexes.rb
@@ -67,9 +74,8 @@ Create an Index on Embedded Document Fields
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can define an index on embedded document fields. The following code example
-shows how to declare an ascending index on the ``street`` field in the
-``Restaurant`` class where ``street`` is a field embedded within the ``address``
-field.
+shows how to declare an ascending index on the ``street`` field, which is embedded
+within the ``address`` field in the ``Restaurant`` model.
 
 .. literalinclude:: /includes/reference/indexes.rb
   :language: ruby
@@ -80,7 +86,7 @@ Create a Compound Index
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 You can define a compound index on multiple fields. The following code example
-shows how to declare a compound index that is ascending on the ``address.street``
+shows how to declare a compound index that is ascending on the ``borough``
 field and descending on the ``name`` field.
 
 .. literalinclude:: /includes/reference/indexes.rb
@@ -102,10 +108,10 @@ objects:
   :end-before: end create 2dsphere index
 
 For more information on 2dsphere indexes, see the :manual:`2dsphere </core/indexes/index-types/geospatial/2dsphere/>`
-guide in the {+mdb-server+} manual.
+guide in the MongoDB {+server-manual+}.
 
 For more information on the GeoJSON type, see the :manual:`GeoJSON Objects </reference/geojson/>`
-guide in the {+mdb-server+} manual.
+guide in the MongoDB {+server-manual+}.
 
 Create a Sparse Index
 ~~~~~~~~~~~~~~~~~~~~~
@@ -119,7 +125,7 @@ The following code example defines a sparse index on the ``borough`` field:
   :end-before: end create sparse index
 
 For more information on sparse indexes, see the :manual:`Sparse Indexes </core/index-sparse/>`
-guide in the {+mdb-server+} manual.
+guide in the MongoDB {+server-manual+}.
 
 Create Multiple Indexes
 ~~~~~~~~~~~~~~~~~~~~~~~