diff --git a/source/includes/ref-toc-operator-projection.yaml b/source/includes/ref-toc-operator-projection.yaml index 031d9fa3512..15ffcd2e7d1 100644 --- a/source/includes/ref-toc-operator-projection.yaml +++ b/source/includes/ref-toc-operator-projection.yaml @@ -4,7 +4,7 @@ description: "Projects the first element in an array that matches the query cond --- name: ":projection:`$elemMatch`" file: /reference/projection/elemMatch -description: "Projects only elements from an array that match the specified query condition." +description: "Projects only the first element from an array that matches the specified :projection:`$elemMatch` condition." --- name: ":projection:`$slice`" file: /reference/projection/slice diff --git a/source/includes/ref-toc-operator-query-array.yaml b/source/includes/ref-toc-operator-query-array.yaml index ac15431c780..698f315960a 100644 --- a/source/includes/ref-toc-operator-query-array.yaml +++ b/source/includes/ref-toc-operator-query-array.yaml @@ -1,6 +1,6 @@ name: ":operator:`$elemMatch`" file: /reference/operator/elemMatch -description: "Selects documents if element in an array that match the specified query clause." +description: "Selects documents if element in the array field matches all the specified :operator:`$elemMatch` condition." --- name: ":operator:`$size`" file: /reference/operator/size diff --git a/source/includes/ref-toc-operator-query-comparison.yaml b/source/includes/ref-toc-operator-query-comparison.yaml index 0427e0e1118..9634319e1d6 100644 --- a/source/includes/ref-toc-operator-query-comparison.yaml +++ b/source/includes/ref-toc-operator-query-comparison.yaml @@ -4,23 +4,23 @@ description: "Matches arrays that contain all elements specified in the query." --- name: ":operator:`$gt`" file: /reference/operator/gt -description: "Matches values that are larger than the value specified in the query." +description: "Matches values that are greater than the value specified in the query." --- name: ":operator:`$gte`" file: /reference/operator/gte -description: "Matches values that are equal to or larger than the value specified in the query." +description: "Matches values that are equal to or greater than the value specified in the query." --- name: ":operator:`$in`" file: /reference/operator/in -description: "Matches any of the values that exist in an array specified to the query." +description: "Matches any of the values that exist in an array specified in the query." --- name: ":operator:`$lt`" file: /reference/operator/lt -description: "Matches vales that are smaller than the value specified in the query." +description: "Matches vales that are less than the value specified in the query." --- name: ":operator:`$lte`" file: /reference/operator/lte -description: "Matches values that are smaller or equal to the value specified in the query." +description: "Matches values that are less than or equal to the value specified in the query." --- name: ":operator:`$ne`" file: /reference/operator/ne diff --git a/source/includes/ref-toc-operator-query-geospatial-modifiers.yaml b/source/includes/ref-toc-operator-query-geospatial-modifiers.yaml index ac46e10b76b..c9c9e70ca08 100644 --- a/source/includes/ref-toc-operator-query-geospatial-modifiers.yaml +++ b/source/includes/ref-toc-operator-query-geospatial-modifiers.yaml @@ -12,7 +12,7 @@ description: "Specifies a circle using legacy coordinate pairs to :operator:`$ge --- name: ":operator:`$centerSphere`" file: /reference/operator/centerSphere -description: "Specifies a circle using legacy coordinate pairs for :operator:`$geoWithin` queries when using spherical geometry." +description: "Specifies a circle using either legacy coordinate pairs or :term:`GeoJSON` format for :operator:`$geoWithin` queries when using spherical geometry." --- name: ":operator:`$box`" file: /reference/operator/box @@ -24,5 +24,5 @@ description: "Specifies a polygon to using legacy coordinate pairs for :operator --- name: ":operator:`$uniqueDocs`" file: /reference/operator/uniqueDocs -description: "Modifies a geospatial query using a ``2d`` index to ensure that a query will only return a single document once." +description: "Modifies a :operator:`$geoWithin` and :operator:`$near` queries to ensure that even if a document matches the query multiple times, the query returns the document once." ... \ No newline at end of file diff --git a/source/includes/ref-toc-operator-query-geospatial.yaml b/source/includes/ref-toc-operator-query-geospatial.yaml index d44649c1df9..cd277b4291b 100644 --- a/source/includes/ref-toc-operator-query-geospatial.yaml +++ b/source/includes/ref-toc-operator-query-geospatial.yaml @@ -1,10 +1,10 @@ name: ":operator:`$geoWithin`" file: /reference/operator/geoWithin -description: "Selects geometries within a bounding polygon." +description: "Selects geometries within a bounding :term:`GeoJSON` shape." --- name: ":operator:`$geoIntersects`" file: /reference/operator/geoIntersects -description: "Selects geometries that intersect with a polygon." +description: "Selects geometries that intersect with a :term:`GeoJSON` shape." --- name: ":operator:`$near`" file: /reference/operator/near diff --git a/source/includes/ref-toc-operator-update-array-modifiers.yaml b/source/includes/ref-toc-operator-update-array-modifiers.yaml index 2950ddb7fdc..b10a3711c5e 100644 --- a/source/includes/ref-toc-operator-update-array-modifiers.yaml +++ b/source/includes/ref-toc-operator-update-array-modifiers.yaml @@ -1,6 +1,6 @@ name: ":operator:`$each`" file: /reference/operator/each -description: "Modifies the :operator:`$push` and :operator:`$addToSet` operators to specify multiple items for array updates. " +description: "Modifies the :operator:`$push` and :operator:`$addToSet` operators to append multiple items for array updates." --- name: ":operator:`$slice`" file: /reference/operator/slice diff --git a/source/includes/ref-toc-operator-update-array.yaml b/source/includes/ref-toc-operator-update-array.yaml index fa2d3f19fb3..0c309542ef1 100644 --- a/source/includes/ref-toc-operator-update-array.yaml +++ b/source/includes/ref-toc-operator-update-array.yaml @@ -1,6 +1,6 @@ name: ":operator:`$`" file: /reference/operator/positional -description: "Updates an element of an array selected in the query, referenced by position in the array." +description: "Acts as a placeholder to update the first element that matches the query condition in an update." --- name: ":operator:`$addToSet`" file: /reference/operator/addToSet @@ -20,7 +20,7 @@ description: "Removes items from an array that match a query statement." --- name: ":operator:`$pushAll`" file: /reference/operator/pushAll -description: "Deprecated. Adds several items to an array." +description: "*Deprecated.* Adds several items to an array." --- name: ":operator:`$push`" file: /reference/operator/push diff --git a/source/includes/ref-toc-operator-update-field.yaml b/source/includes/ref-toc-operator-update-field.yaml index 515de974af2..ba8eeeda4eb 100644 --- a/source/includes/ref-toc-operator-update-field.yaml +++ b/source/includes/ref-toc-operator-update-field.yaml @@ -8,7 +8,7 @@ description: "Renames a field." --- name: ":operator:`$setOnInsert`" file: /reference/operator/setOnInsert -description: "Sets the value of a field upon documentation creation. Has no effect on update operations that modify existing documents." +description: "Sets the value of a field upon documentation creation during an upsert. Has no effect on update operations that modify existing documents." --- name: ":operator:`$set`" file: /reference/operator/set diff --git a/source/reference/operator/uniqueDocs.txt b/source/reference/operator/uniqueDocs.txt index 645d1f1a013..afadba41760 100644 --- a/source/reference/operator/uniqueDocs.txt +++ b/source/reference/operator/uniqueDocs.txt @@ -14,7 +14,7 @@ $uniqueDocs contains multiple coordinate values. You can use :operator:`$uniqueDocs` only with the - :operator:`$geoWithin` and :operator:`$geoWithin` operators. The + :operator:`$geoWithin` and :operator:`$near` operators. The ``2d`` geospatial index supports :operator:`$uniqueDocs`. .. example:: @@ -30,13 +30,13 @@ $uniqueDocs .. code-block:: javascript - db.list.find( { addrs.loc : { $geoWithin : { $box : [ [ 0 , 0 ] , [ 100 , 100 ] ] } } } ) + db.list.find( { "addrs.loc" : { $geoWithin : { $box : [ [ 0 , 0 ] , [ 100 , 100 ] ] } } } ) The following query would return each matching document only once: .. code-block:: javascript - db.list.find( { addrs.loc : { $geoWithin : { $box : [ [ 0 , 0 ] , [ 100 , 100 ] ], $uniqueDocs: true } } } ) + db.list.find( { "addrs.loc" : { $geoWithin : { $box : [ [ 0 , 0 ] , [ 100 , 100 ] ], $uniqueDocs: true } } } ) .. note:: If you specify a value of ``false`` for :operator:`$uniqueDocs`, MongoDB will return multiple instances of