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

jeff-allen-mongo · web-flow · commit 2315d78b7f48 · 2023-01-18T11:46:49.000-05:00
* (DOCSP-27350): Update Atlas Search callouts - follow up (#2397) * (DOCSP-27350): Update Atlas Search callouts - follow up (#2336) * (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 * fix build warnings * fix text-search toc * add missing aggregation ref * fix include name
diff --git a/source/aggregation.txt b/source/aggregation.txt
@@ -1,3 +1,5 @@
+.. _aggregation:
+
 ===========
 Aggregation
 ===========
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,6 +1,8 @@
-============
-Text Indexes
-============
+.. _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,6 +1,8 @@
-=====================
-Text Search Operators
-=====================
+.. _text-search-operators-on-premises:
+
+================================================
+Text Search Operators (Self-Managed Deployments)
+================================================
 
 .. default-domain:: mongodb
 
@@ -10,9 +12,7 @@ Text Search Operators
    :depth: 1
    :class: singlecol
 
-.. note::
-
-   .. include:: /includes/extracts/views-unsupported-text-search.rst
+.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst
 
 Query Framework
 ---------------
diff --git a/source/core/text-search/on-prem.txt b/source/core/text-search/on-prem.txt
@@ -0,0 +1,15 @@
+.. _text-search-on-prem:
+
+=======================================
+Text Search on Self-Managed Deployments
+=======================================
+
+.. default-domain:: mongodb
+
+.. toctree::
+   :titlesonly:
+
+   /core/link-text-indexes
+   /core/text-search-operators
+   /tutorial/text-search-in-aggregation
+   /reference/text-search-languages
diff --git a/source/includes/extracts-atlas-search-facts.yaml b/source/includes/extracts-atlas-search-facts.yaml
@@ -0,0 +1,29 @@
+ref: fact-text-search-legacy-atlas
+content: |
+
+  .. 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
+content: |
+
+  **For data hosted on MongoDB Atlas**, MongoDB offers a 
+  full-text search solution, :atlas:`MongoDB Atlas Search 
+  </atlas-search/>`. If you frequently run case-insensitive regex 
+  queries (utilizing the ``i`` option), MongoDB recommends Atlas Search 
+  queries that use the :pipeline:`$search` aggregation pipeline stage. 
+  
+  :atlas:`Atlas Search queries </reference/atlas-search/searching/>` 
+  significiantly improve the performance of text queries and offer more 
+  options for customizing query parameters. To learn more, see 
+  :atlas:`MongoDB Atlas Search </atlas-search/>`. 
+  
+  **For self-managed deployments**, you can find information on our 
+  regex capability below.
+
+...
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 :doc:`2dsphere indexes
 See :doc:`/core/geospatial-indexes` 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
@@ -12,7 +12,16 @@ $regex
 
 .. meta::
    :description: pattern matching on strings in MongoDB |version|
-   :keywords: regex, regular expressions, LIKE queries, wildcard matches, pattern matches, MongoDB |version|, version |version| 
+   :keywords: regex, regular expressions, LIKE queries, wildcard matches, pattern matches, MongoDB |version|, version |version|
+
+.. 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
@@ -10,109 +10,54 @@ Text Search
    :depth: 1
    :class: singlecol
 
-Overview
---------
+MongoDB provides different text search capabilities depending on whether
+your data is hosted on :atlas:`MongoDB Atlas </>` or a self-managed
+deployment.
 
-MongoDB 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.
+MongoDB Atlas Search
+--------------------
 
-.. note::
-
-   .. include:: /includes/extracts/views-unsupported-text-search.rst
-
-Example
--------
-
-This example demonstrates how to build a text index and use it to find
-coffee shops, given only text fields.
-
-Create a collection ``stores`` with the following documents:
-
-.. code-block:: javascript
-
-   db.stores.insert(
-      [
-        { _id: 1, name: "Java Hut", description: "Coffee and cakes" },
-        { _id: 2, name: "Burger Buns", description: "Gourmet hamburgers" },
-        { _id: 3, name: "Coffee Shop", description: "Just coffee" },
-        { _id: 4, name: "Clothes Clothes Clothes", description: "Discount clothing" },
-        { _id: 5, name: "Java Shopping", description: "Indonesian goods" }
-      ]
-   )
-
-Text Index
-~~~~~~~~~~
-
-.. include:: /includes/fact-text-index.rst
-
-.. include:: /includes/fact-create-text-index.rst
-
-``$text`` Operator
-~~~~~~~~~~~~~~~~~~
-
-.. include:: /includes/fact-use-text-operator.rst
+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.
 
-Exact Phrase
-````````````
+To learn more and get started with Atlas Search, see: 
 
-You can also search for exact phrases by wrapping them in double-quotes.
-If the ``$search`` string includes a phrase and individual terms, text search
-will only match documents that include the phrase.
+- :atlas:`Atlas Search Aggregation Pipeline Stages 
+  </reference/atlas-search/query-syntax/>`
+- :atlas:`Defining Atlas Search Indexes 
+  </reference/atlas-search/index-definitions/>`
+- :atlas:`Running Atlas Search Queries 
+  </reference/atlas-search/searching/>`
 
-For example, the following will find all documents containing
-"coffee shop":
-
-.. code-block:: javascript
-
-   db.stores.find( { $text: { $search: "\"coffee shop\"" } } )
-
-For more information, see :ref:`text-operator-phrases`.
-
-Term Exclusion
-``````````````
-
-To exclude a word, you can prepend a "``-``" character. For example, to
-find all stores containing "java" or "shop" but not "coffee", use the
-following:
-
-.. code-block:: javascript
-
-   db.stores.find( { $text: { $search: "java shop -coffee" } } )
-
-Sorting
-```````
-
-MongoDB will return its results in unsorted order by default. However,
-text search queries will compute a relevance score for each document
-that specifies how well a document matches the query.
+.. include:: /includes/fact-atlas-search-languages.rst
 
-To sort the results in order of relevance score, you must explicitly
-project the :expression:`$meta` ``textScore`` field and sort on it:
+Text Search on Self-Managed Deployments
+---------------------------------------
 
-.. code-block:: javascript
+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. 
 
-   db.stores.find(
-      { $text: { $search: "java coffee shop" } },
-      { score: { $meta: "textScore" } }
-   ).sort( { score: { $meta: "textScore" } } )
+.. note::
 
-Text search is also available in the aggregation pipeline.
+   .. include:: /includes/extracts/views-unsupported-text-search.rst
 
-Language Support
-----------------
+To learn more about text search for self-managed deployments, see: 
+      
+- :doc:`Text Indexes </core/link-text-indexes/>` 
+- :doc:`Text Search Operators </core/text-search-operators/>`
 
-MongoDB 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`.
 
 .. include:: /includes/fact-atlas-search-languages.rst
 
 .. toctree::
    :titlesonly:
    :hidden:
-
-   /core/link-text-indexes
-   /core/text-search-operators
-   /tutorial/text-search-in-aggregation
-   /reference/text-search-languages
+   
+   MongoDB Atlas Search <https://www.mongodb.com/docs/atlas/atlas-search/>
+   /core/text-search/on-prem
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
-

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+.. _aggregation:`
	`2`	`+`
`1`	`3`	`===========`
`2`	`4`	`Aggregation`
`3`	`5`	`===========`