(DOCSP-13152): Improve Atlas Search callouts

jeff-allen-mongo · jeff-allen-mongo · commit 7b2d5e37f7bc · 2021-02-11T11:42:24.000-05:00
diff --git a/source/core/index-text.txt b/source/core/index-text.txt
@@ -12,8 +12,6 @@ Text Indexes
    :depth: 1
    :class: singlecol
 
-.. include:: /includes/fact-atlas-search-banner.rst
-
 Overview
 --------
 
diff --git a/source/core/text-search-operators.txt b/source/core/text-search-operators.txt
@@ -53,6 +53,8 @@ For more information and examples of text search in the
 :doc:`/aggregation` framework, see
 :doc:`/tutorial/text-search-in-aggregation`.
 
+.. include:: /includes/fact-atlas-search-search-stage.rst
+
 .. [#meta-aggregation]
 
    .. include:: /includes/fact-meta-operator-disambiguation.rst
diff --git a/source/includes/fact-atlas-search-languages.rst b/source/includes/fact-atlas-search-languages.rst
@@ -0,0 +1,4 @@
+For data hosted on `MongoDB Atlas
+<https://www.mongodb.com/cloud/atlas?tck=docs_server>`__, :atlas:`Atlas
+Search </atlas-search>` provides support for additional languages not
+listed on this page.
diff --git a/source/includes/fact-atlas-search-search-stage.rst b/source/includes/fact-atlas-search-search-stage.rst
@@ -0,0 +1,3 @@
+For data hosted on MongoDB Atlas, Atlas Search provides the
+:atlas:`$search </reference/atlas-search/query-syntax/>` aggregation
+stage to perform full-text search on your collections.
diff --git a/source/includes/fact-text-index-limit-one.rst b/source/includes/fact-text-index-limit-one.rst
@@ -1 +1,6 @@
 A collection can have at most **one** ``text`` index.
+
+Atlas Search (available in `MongoDB Atlas
+<https://www.mongodb.com/cloud/atlas?tck=docs_server>`__) supports
+multiple ``text`` indexes on a single collection. To learn more, see the
+:atlas:`Atlas Search documentation </atlas-search>`.
diff --git a/source/reference/operator/query/text.txt b/source/reference/operator/query/text.txt
@@ -10,8 +10,6 @@ $text
    :depth: 1
    :class: singlecol
 
-.. include:: /includes/fact-atlas-search-banner.rst
-
 Definition
 ----------
 
@@ -165,6 +163,15 @@ The :query:`text` operator treats most punctuation
 in the string as delimiters, except a hyphen-minus (``-``) that negates term or
 an escaped double quotes ``\"`` that specifies a phrase.
 
+.. note::
+
+   The ``$search`` field for the :query:`$text` expression is different
+   than the the :atlas:`$search aggregation stage
+   </reference/atlas-search/query-syntax/>` provided by Atlas Search.
+   The ``$search`` aggregation stage performs full-text search on
+   specified fields and is only available on `MongoDB Atlas
+   <https://www.mongodb.com/cloud/atlas?tck=docs_server>`__.
+
 .. _text-operator-phrases:
 
 Phrases
diff --git a/source/reference/text-search-languages.txt b/source/reference/text-search-languages.txt
@@ -74,5 +74,7 @@ language name:
 
    .. include:: /includes/fact-text-search-language-none.rst
 
+.. include:: /includes/fact-atlas-search-languages.rst
+
 .. seealso:: :doc:`/tutorial/specify-language-for-text-index`
 
diff --git a/source/text-search.txt b/source/text-search.txt
@@ -10,8 +10,6 @@ Text Search
    :depth: 1
    :class: singlecol
 
-.. include:: /includes/fact-atlas-search-banner.rst
-
 Overview
 --------
 
@@ -108,6 +106,8 @@ MongoDB supports text search for various languages. See
 :doc:`/reference/text-search-languages` for a list of supported
 languages.
 
+.. include:: /includes/fact-atlas-search-languages.rst
+
 .. toctree::
    :titlesonly:
    :hidden:
diff --git a/source/tutorial/control-results-of-text-search.txt b/source/tutorial/control-results-of-text-search.txt
@@ -77,3 +77,11 @@ each other. For instance, a term match in the ``content`` field has:
 
 - ``10`` times (i.e. ``10:1``) the impact as a term match in the
   ``about`` field.
+
+.. note::
+
+   For data hosted on `MongoDB Atlas
+   <https://www.mongodb.com/cloud/atlas?tck=docs_server>`__,
+   :atlas:`Atlas Search </atlas-search>` provides more robust custom
+   scoring than ``text`` indexes. To learn more, see the Atlas Search
+   :atlas:`Scoring <reference/atlas-search/scoring/>` documentation.
diff --git a/source/tutorial/text-search-in-aggregation.txt b/source/tutorial/text-search-in-aggregation.txt
@@ -16,7 +16,7 @@ In the aggregation pipeline, text search is available via the use of
 the :query:`$text` query operator in the :pipeline:`$match` stage.
 
 Restrictions
-~~~~~~~~~~~~
+------------
 
 For general :query:`$text` operator restrictions, see :ref:`operator
 restrictions <text-query-operator-behavior>`.
@@ -36,7 +36,7 @@ restrictions:
 .. |sort-object| replace:: :pipeline:`$sort` pipeline
 
 Text Score
-~~~~~~~~~~
+----------
 
 .. include:: /includes/fact-text-search-score.rst
 
@@ -132,3 +132,8 @@ matching documents in the :pipeline:`$group` stage.
         { $group: { _id: null, views: { $sum: "$views" } } }
       ]
    )
+
+``$search`` Stage in Atlas Search
+---------------------------------
+
+.. include:: /includes/fact-atlas-search-search-stage.rst

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+For data hosted on MongoDB Atlas, Atlas Search provides the`
	`2`	+:atlas:`$search </reference/atlas-search/query-syntax/>` aggregation
	`3`	`+stage to perform full-text search on your collections.`