(DOCSP-27350): Update Atlas Search callouts - follow up (#2336)

jeff-allen-mongo · web-flow · commit 5a0f0d659121 · 2023-01-17T19:13:55.000-05:00
* (DOCSP-27350): Update Atlas Search callouts - follow up * tweak language in include * more edits * tweak formatting in indexes overview * change page titles to use 'self managed' * remove note about view support * update regex intro * external review feedback * formatting
diff --git a/source/core/index-text.txt b/source/core/index-text.txt
@@ -12,6 +12,8 @@ Text Indexes
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst
+
 Overview
 --------
 
diff --git a/source/core/link-text-indexes.txt b/source/core/link-text-indexes.txt
@@ -1,8 +1,8 @@
 .. _text-search-on-premises:
 
-===================================
-Perform a Text Search (On-Premises)
-===================================
+================================================
+Perform a Text Search (Self-Managed Deployments)
+================================================
 
 .. default-domain:: mongodb
 
diff --git a/source/core/text-search-operators.txt b/source/core/text-search-operators.txt
@@ -1,8 +1,8 @@
 .. _text-search-operators-on-premises:
 
-===================================
-Text Search Operators (On-Premises)
-===================================
+================================================
+Text Search Operators (Self-Managed Deployments)
+================================================
 
 .. default-domain:: mongodb
 
@@ -14,10 +14,6 @@ Text Search Operators (On-Premises)
 
 .. include:: /includes/extracts/fact-text-search-legacy-atlas.rst
 
-.. note::
-
-   .. include:: /includes/extracts/views-unsupported-text-search.rst
-
 Query Framework
 ---------------
 
diff --git a/source/core/text-search/on-prem.txt b/source/core/text-search/on-prem.txt
@@ -1,8 +1,8 @@
 .. _text-search-on-prem:
 
-=======================
-On-Premises Text Search
-=======================
+=======================================
+Text Search on Self-Managed Deployments
+=======================================
 
 .. default-domain:: mongodb
 
diff --git a/source/includes/extracts-atlas-search-facts.yaml b/source/includes/extracts-atlas-search-facts.yaml
@@ -1,10 +1,12 @@
 ref: fact-text-search-legacy-atlas
 content: |
 
-  MongoDB offers a :atlas:`full-text search solution, MongoDB Atlas
-  Search </atlas-search/>`, for data hosted on :atlas:`MongoDB Atlas
-  </>`. Users running self-managed MongoDB deployments have access to
-  on-premises text search capabilities. 
+  .. note::
+  
+     This page describes text search capabilities for self-managed
+     (non-Atlas) deployments. For data hosted on MongoDB Atlas, MongoDB
+     offers an improved full-text search solution, :atlas:`Atlas Search
+     </atlas-search/>`.
 
 ---
 ref: fact-regex-search-legacy-atlas
diff --git a/source/includes/indexes/text-search-indexes-overview.rst b/source/includes/indexes/text-search-indexes-overview.rst
@@ -0,0 +1,8 @@
+For data hosted on MongoDB Atlas, you can support full-text search with
+Atlas Search indexes. To learn more, see :atlas:`Create an Atlas Search
+Index </atlas-search/create-index/>`.
+
+For self-managed (non-Atlas) deployments, MongoDB provides a ``text``
+index type that supports searching for string content in a collection.
+To learn more about self-managed text indexes, see
+:ref:`index-feature-text`.
diff --git a/source/indexes.txt b/source/indexes.txt
@@ -176,16 +176,10 @@ planar geometry when returning results and :ref:`2dsphere indexes
 See :ref:`index-feature-geospatial` for a high level introduction to
 geospatial indexes.
 
-Text Indexes
-~~~~~~~~~~~~
-
-MongoDB provides a ``text`` index type that supports searching
-for string content in a collection. These text indexes do not store
-language-specific *stop* words (e.g. "the", "a", "or") and *stem* the
-words in a collection to only store root words.
+Text Search Indexes
+~~~~~~~~~~~~~~~~~~~
 
-See :doc:`/core/index-text` for more information on text indexes and
-search.
+.. include:: /includes/indexes/text-search-indexes-overview.rst
 
 Hashed Indexes
 ~~~~~~~~~~~~~~
diff --git a/source/reference/operator/query/regex.txt b/source/reference/operator/query/regex.txt
@@ -14,7 +14,14 @@ $regex
    :description: pattern matching on strings in MongoDB {+latest-lts-version+}
    :keywords: regex, regular expressions, LIKE queries, wildcard matches, pattern matches, MongoDB {+latest-lts-version+}, version {+latest-lts-version+}
 
-.. include:: /includes/extracts/fact-regex-search-legacy-atlas.rst
+.. note::
+
+   This page describes regular expression search capabilities for
+   self-managed (non-Atlas) deployments. For data hosted on MongoDB
+   Atlas, MongoDB offers an improved full-text search solution,
+   :atlas:`Atlas Search </atlas-search/>`, which has its own ``$regex``
+   operator. To learn more, see :atlas:`$regex </atlas-search/regex/>`
+   in the Atlas Search documentation.
 
 Definition
 ----------
diff --git a/source/text-search.txt b/source/text-search.txt
@@ -12,15 +12,19 @@ Text Search
    :depth: 1
    :class: singlecol
 
-.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst
+MongoDB provides different text search capabilities depending on whether
+your data is hosted on :atlas:`MongoDB Atlas </>` or a self-managed
+deployment.
 
 MongoDB Atlas Search
 --------------------
 
-For MongoDB Atlas users, MongoDB's Atlas Search supports fine-grained 
-text indexing and a rich query language for fast, relevant search 
-results. To learn more about full-text search indexes and 
-:pipeline:`$search` queries, see: 
+To perform text search on data hosted on MongoDB Atlas, use
+:atlas:`MongoDB Atlas Search </atlas-search>`. Atlas Search supports
+fine-grained text indexing and a rich query language for fast, relevant
+search results.
+
+To learn more and get started with Atlas Search, see: 
 
 - :atlas:`Atlas Search Aggregation Pipeline Stages 
   </reference/atlas-search/query-syntax/>`
@@ -31,10 +35,10 @@ results. To learn more about full-text search indexes and
 
 .. include:: /includes/fact-atlas-search-languages.rst
 
-On-Premises Text Search 
------------------------
+Text Search on Self-Managed Deployments
+---------------------------------------
 
-For on-premises (non-Atlas) deployments, MongoDB's text search
+For self-managed (non-Atlas) deployments, MongoDB's text search
 capability supports query operations that perform a text search of
 string content. To perform text search, MongoDB uses a :ref:`text index
 <index-feature-text>` and the :query:`$text` operator. 
@@ -43,14 +47,13 @@ string content. To perform text search, MongoDB uses a :ref:`text index
 
    .. include:: /includes/extracts/views-unsupported-text-search.rst
 
-To learn more about text search for on-premises deployments, see: 
+To learn more about text search for self-managed deployments, see: 
       
 - :ref:`Text Indexes <text-search-on-premises>` 
 - :ref:`Text Search Operators <text-search-operators-on-premises>`
 
-MongoDB also supports text search for various languages. See
-:doc:`/reference/text-search-languages` for a list of supported
-languages.
+MongoDB also supports text search for various languages. For a list of
+supported languages, see :ref:`text-search-languages`.
 
 .. toctree::
    :titlesonly:
diff --git a/source/tutorial/create-indexes-to-support-queries.txt b/source/tutorial/create-indexes-to-support-queries.txt
@@ -88,8 +88,12 @@ can support all the queries that search a "prefix" subset of those fields.
 
 .. include:: /includes/fact-index-intersection-vs-compound-indexes.rst
 
+Create Indexes to Support Text Search
+-------------------------------------
+
+.. include:: /includes/indexes/text-search-indexes-overview.rst
+
 Index Use and Collation
 -----------------------
 
 .. include:: /includes/extracts/collation-index-use.rst
-
