From dfa34c58f52d0166828feec7986a6a883e89c74c Mon Sep 17 00:00:00 2001
From: Kanchana Sekhar <kanchana.sekhar@mongodb.com>
Date: Thu, 7 Oct 2021 08:17:01 -0700
Subject: [PATCH 1/6] DOCSP-17260 Direct Text Search traffic to Atlas Search

---
 source/core/link-text-indexes.txt          |  26 ++++-
 source/core/text-search-operators.txt      |  46 ++++++++-
 source/includes/fact-create-text-index.rst |   8 +-
 source/includes/fact-text-index.rst        |   5 +-
 source/includes/fact-use-text-operator.rst |   3 +-
 source/text-search.txt                     | 115 ++++++---------------
 6 files changed, 107 insertions(+), 96 deletions(-)

diff --git a/source/core/link-text-indexes.txt b/source/core/link-text-indexes.txt
index a8ef7c35123..b4a17734325 100644
--- a/source/core/link-text-indexes.txt
+++ b/source/core/link-text-indexes.txt
@@ -6,7 +6,29 @@ Text Indexes
 
 .. include:: /includes/fact-text-index.rst
 
-.. include:: /includes/fact-create-text-index.rst
-
 See the :doc:`/core/index-text` section for a full reference on text
 indexes, including behavior, tokenization, and properties.
+
+.. _text-index-eg:
+
+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" }
+      ]
+   )
+
+.. include:: /includes/fact-create-text-index.rst
diff --git a/source/core/text-search-operators.txt b/source/core/text-search-operators.txt
index 6f9ce0bea86..997a80b4e1e 100644
--- a/source/core/text-search-operators.txt
+++ b/source/core/text-search-operators.txt
@@ -39,6 +39,51 @@ operators, including restrictions and behavior, see:
 
 - :expression:`$meta` projection operator
 
+Exact Phrase
+````````````
+
+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.
+
+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.
+
+To sort the results in order of relevance score, you must explicitly
+project the :expression:`$meta` ``textScore`` field and sort on it:
+
+.. code-block:: javascript
+
+   db.stores.find(
+      { $text: { $search: "java coffee shop" } },
+      { score: { $meta: "textScore" } }
+   ).sort( { score: { $meta: "textScore" } } )
+
+Text search is also available in the aggregation pipeline.
 
 Aggregation Framework
 ---------------------
@@ -58,4 +103,3 @@ For more information and examples of text search in the
 .. [#meta-aggregation]
 
    .. include:: /includes/fact-meta-operator-disambiguation.rst
-   
\ No newline at end of file
diff --git a/source/includes/fact-create-text-index.rst b/source/includes/fact-create-text-index.rst
index 59d75331f22..741295b0a0a 100644
--- a/source/includes/fact-create-text-index.rst
+++ b/source/includes/fact-create-text-index.rst
@@ -1,9 +1,5 @@
-To perform text search queries, you must have a
-``text`` index on your collection. A collection can only have **one**
-text search index, but that index can cover multiple fields.
-
-For example you can run the following in :binary:`~bin.mongosh` to
-allow text search over the ``name`` and ``description`` fields:
+You can run the following in :binary:`~bin.mongosh` to allow text 
+search over the ``name`` and ``description`` fields:
 
 .. code-block:: javascript
 
diff --git a/source/includes/fact-text-index.rst b/source/includes/fact-text-index.rst
index 7435955f92b..11eb132b9c8 100644
--- a/source/includes/fact-text-index.rst
+++ b/source/includes/fact-text-index.rst
@@ -1,3 +1,6 @@
 MongoDB provides :ref:`text indexes <index-feature-text>` to support
 text search queries on string content. ``text`` indexes can include any
-field whose value is a string or an array of string elements.
+field whose value is a string or an array of string elements. To 
+perform text search queries, you must have a ``text`` index on your 
+collection. A collection can only have **one** text search index, but 
+that index can cover multiple fields.
diff --git a/source/includes/fact-use-text-operator.rst b/source/includes/fact-use-text-operator.rst
index e1583bc7d4a..6aa5b8de028 100644
--- a/source/includes/fact-use-text-operator.rst
+++ b/source/includes/fact-use-text-operator.rst
@@ -6,7 +6,8 @@ punctuation as delimiters, and perform a logical ``OR`` of all such
 tokens in the search string.
 
 For example, you could use the following query to find all stores
-containing any terms from the list "coffee", "shop", and "java":
+containing any terms from the list "coffee", "shop", and "java" in 
+the ``stores`` :ref:`collection <text-index-eg>`:
 
 .. code-block:: javascript
 
diff --git a/source/text-search.txt b/source/text-search.txt
index 3d284fd1fc0..2f8959112e9 100644
--- a/source/text-search.txt
+++ b/source/text-search.txt
@@ -10,104 +10,49 @@ Text Search
    :depth: 1
    :class: singlecol
 
-Overview
---------
+MongoDB offers a premium full-text search solution, MongoDB Atlas 
+Search, for MongoDB Atlas users and a legacy text search capability for 
+self-managed deployments. 
 
-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
-
-Exact Phrase
-````````````
+For MongoDB Atlas users, MongoDB's Atlas Search supports fine-grained 
+text indexing using several kinds of text analyzers and searching using 
+a rich query language. To learn more about full-text search indexes and 
+:pipeline:`$search` queries, 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:
+Legacy Text Search 
+------------------
 
-.. code-block:: javascript
+For self-managed deployments, MongoDB's legacy 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
-----------------
+Users running MongoDB software locally can find information on the 
+legacy text search here: 
+      
+- :doc:`Text Indexes </core/link-text-indexes/>` 
+- :doc:`Text Search Operators </core-text-search-operators/>`
 
-MongoDB supports text search for various languages. See
+MongoDB also 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:

From 17ecefa1599965a804781a7cf269e773e8551cc3 Mon Sep 17 00:00:00 2001
From: Kanchana Sekhar <kanchana.sekhar@mongodb.com>
Date: Thu, 7 Oct 2021 18:29:39 -0700
Subject: [PATCH 2/6] DOCSP-17260 updates for copy review feedback

---
 source/core/link-text-indexes.txt          | 57 ++++++++++++++++++++--
 source/core/text-search-operators.txt      | 48 +-----------------
 source/includes/fact-create-text-index.rst |  4 +-
 source/includes/fact-text-index.rst        | 10 ++--
 source/text-search.txt                     |  4 +-
 5 files changed, 63 insertions(+), 60 deletions(-)

diff --git a/source/core/link-text-indexes.txt b/source/core/link-text-indexes.txt
index b4a17734325..70a4bff454c 100644
--- a/source/core/link-text-indexes.txt
+++ b/source/core/link-text-indexes.txt
@@ -1,9 +1,12 @@
-============
-Text Indexes
-============
+=====================
+Perform a Text Search 
+=====================
 
 .. default-domain:: mongodb
 
+Overview 
+--------
+
 .. include:: /includes/fact-text-index.rst
 
 See the :doc:`/core/index-text` section for a full reference on text
@@ -21,7 +24,7 @@ Create a collection ``stores`` with the following documents:
 
 .. code-block:: javascript
 
-   db.stores.insert(
+   db.stores.insertMany(
       [
         { _id: 1, name: "Java Hut", description: "Coffee and cakes" },
         { _id: 2, name: "Burger Buns", description: "Gourmet hamburgers" },
@@ -32,3 +35,49 @@ Create a collection ``stores`` with the following documents:
    )
 
 .. include:: /includes/fact-create-text-index.rst
+
+Search for an Exact Phrase
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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.
+
+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`.
+
+Exclude a Term 
+~~~~~~~~~~~~~~
+
+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" } } )
+
+Sort the Results
+~~~~~~~~~~~~~~~~
+
+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.
+
+To sort the results in order of relevance score, you must explicitly
+project the :expression:`$meta` ``textScore`` field and sort on it:
+
+.. code-block:: javascript
+
+   db.stores.find(
+      { $text: { $search: "java coffee shop" } },
+      { score: { $meta: "textScore" } }
+   ).sort( { score: { $meta: "textScore" } } )
+
+Text search is also available in the aggregation pipeline.
diff --git a/source/core/text-search-operators.txt b/source/core/text-search-operators.txt
index 997a80b4e1e..0d72952320d 100644
--- a/source/core/text-search-operators.txt
+++ b/source/core/text-search-operators.txt
@@ -39,58 +39,12 @@ operators, including restrictions and behavior, see:
 
 - :expression:`$meta` projection operator
 
-Exact Phrase
-````````````
-
-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.
-
-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.
-
-To sort the results in order of relevance score, you must explicitly
-project the :expression:`$meta` ``textScore`` field and sort on it:
-
-.. code-block:: javascript
-
-   db.stores.find(
-      { $text: { $search: "java coffee shop" } },
-      { score: { $meta: "textScore" } }
-   ).sort( { score: { $meta: "textScore" } } )
-
-Text search is also available in the aggregation pipeline.
-
 Aggregation Framework
 ---------------------
 
 When working with the :doc:`/aggregation` framework, use
 :pipeline:`$match` with a :query:`$text` expression to execute a text
-search query. To sort the results in order of relevance score,use the
+search query. To sort the results in order of relevance score, use the
 :expression:`$meta` *aggregation operator* in the :pipeline:`$sort`
 stage [#meta-aggregation]_.
 
diff --git a/source/includes/fact-create-text-index.rst b/source/includes/fact-create-text-index.rst
index 741295b0a0a..69677701025 100644
--- a/source/includes/fact-create-text-index.rst
+++ b/source/includes/fact-create-text-index.rst
@@ -1,5 +1,5 @@
-You can run the following in :binary:`~bin.mongosh` to allow text 
-search over the ``name`` and ``description`` fields:
+Run the following in :binary:`~bin.mongosh` to allow text search over 
+the ``name`` and ``description`` fields:
 
 .. code-block:: javascript
 
diff --git a/source/includes/fact-text-index.rst b/source/includes/fact-text-index.rst
index 11eb132b9c8..38cf6f4fe9b 100644
--- a/source/includes/fact-text-index.rst
+++ b/source/includes/fact-text-index.rst
@@ -1,6 +1,6 @@
-MongoDB provides :ref:`text indexes <index-feature-text>` to support
-text search queries on string content. ``text`` indexes can include any
-field whose value is a string or an array of string elements. To 
-perform text search queries, you must have a ``text`` index on your 
-collection. A collection can only have **one** text search index, but 
+To perform text search queries, you must have a ``text`` index on your 
+collection. MongoDB provides :ref:`text indexes <index-feature-text>` 
+to support text search queries on string content. ``text`` indexes can 
+include any field whose value is a string or an array of string 
+elements. A collection can only have **one** text search index, but 
 that index can cover multiple fields.
diff --git a/source/text-search.txt b/source/text-search.txt
index 2f8959112e9..84c07284ce0 100644
--- a/source/text-search.txt
+++ b/source/text-search.txt
@@ -43,8 +43,8 @@ To perform text search, MongoDB uses a :ref:`text index
 
    .. include:: /includes/extracts/views-unsupported-text-search.rst
 
-Users running MongoDB software locally can find information on the 
-legacy text search here: 
+To learn more about legacy text search for self-managed deployments, 
+see: 
       
 - :doc:`Text Indexes </core/link-text-indexes/>` 
 - :doc:`Text Search Operators </core-text-search-operators/>`

From e83daad8ffcad2c2c70c082f114fe6eae5f7a6d4 Mon Sep 17 00:00:00 2001
From: Kanchana Sekhar <kanchana.sekhar@mongodb.com>
Date: Fri, 8 Oct 2021 13:48:39 -0700
Subject: [PATCH 3/6] DOCSP-17260 2nd round of updates for copy review feedback

---
 source/core/link-text-indexes.txt | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/source/core/link-text-indexes.txt b/source/core/link-text-indexes.txt
index 70a4bff454c..5db9f22c7eb 100644
--- a/source/core/link-text-indexes.txt
+++ b/source/core/link-text-indexes.txt
@@ -4,9 +4,6 @@ Perform a Text Search
 
 .. default-domain:: mongodb
 
-Overview 
---------
-
 .. include:: /includes/fact-text-index.rst
 
 See the :doc:`/core/index-text` section for a full reference on text
@@ -14,12 +11,15 @@ indexes, including behavior, tokenization, and properties.
 
 .. _text-index-eg:
 
-Example
--------
+Examples
+--------
 
 This example demonstrates how to build a text index and use it to find
 coffee shops, given only text fields.
 
+Create a Collection 
+~~~~~~~~~~~~~~~~~~~
+
 Create a collection ``stores`` with the following documents:
 
 .. code-block:: javascript
@@ -34,6 +34,9 @@ Create a collection ``stores`` with the following documents:
       ]
    )
 
+Create a Text Index 
+~~~~~~~~~~~~~~~~~~~
+
 .. include:: /includes/fact-create-text-index.rst
 
 Search for an Exact Phrase

From 54c5f7973cc6fb04c7ed9f3815001dd33ee3dd58 Mon Sep 17 00:00:00 2001
From: Kanchana Sekhar <kanchana.sekhar@mongodb.com>
Date: Thu, 14 Oct 2021 07:32:03 -0700
Subject: [PATCH 4/6] DOCSP-17260 updates for review feedback

---
 source/core/link-text-indexes.txt                 |  9 ++++++---
 source/core/text-search-operators.txt             |  8 +++++---
 source/includes/fact-text-index.rst               | 12 ++++++------
 source/includes/fact-text-search-legacy-atlas.rst |  3 +++
 source/text-search.txt                            |  4 +---
 5 files changed, 21 insertions(+), 15 deletions(-)
 create mode 100644 source/includes/fact-text-search-legacy-atlas.rst

diff --git a/source/core/link-text-indexes.txt b/source/core/link-text-indexes.txt
index 5db9f22c7eb..2a3efa4f41e 100644
--- a/source/core/link-text-indexes.txt
+++ b/source/core/link-text-indexes.txt
@@ -1,9 +1,12 @@
-=====================
-Perform a Text Search 
-=====================
+==============================
+Perform a Text Search (Legacy)
+==============================
 
 .. default-domain:: mongodb
 
+
+.. include:: /includes/fact-text-search-legacy-atlas.rst
+
 .. include:: /includes/fact-text-index.rst
 
 See the :doc:`/core/index-text` section for a full reference on text
diff --git a/source/core/text-search-operators.txt b/source/core/text-search-operators.txt
index 0d72952320d..38cf0ac7339 100644
--- a/source/core/text-search-operators.txt
+++ b/source/core/text-search-operators.txt
@@ -1,6 +1,6 @@
-=====================
-Text Search Operators
-=====================
+==============================
+Text Search Operators (Legacy) 
+==============================
 
 .. default-domain:: mongodb
 
@@ -10,6 +10,8 @@ Text Search Operators
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-text-search-legacy-atlas.rst
+
 .. note::
 
    .. include:: /includes/extracts/views-unsupported-text-search.rst
diff --git a/source/includes/fact-text-index.rst b/source/includes/fact-text-index.rst
index 38cf6f4fe9b..5ac908091f6 100644
--- a/source/includes/fact-text-index.rst
+++ b/source/includes/fact-text-index.rst
@@ -1,6 +1,6 @@
-To perform text search queries, you must have a ``text`` index on your 
-collection. MongoDB provides :ref:`text indexes <index-feature-text>` 
-to support text search queries on string content. ``text`` indexes can 
-include any field whose value is a string or an array of string 
-elements. A collection can only have **one** text search index, but 
-that index can cover multiple fields.
+To run legacy text search queries, you must have a ``text`` index on 
+your collection. MongoDB provides :ref:`text indexes 
+<index-feature-text>` to support text search queries on string content. 
+``text`` indexes can include any field whose value is a string or an 
+array of string elements. A collection can only have **one** text 
+search index, but that index can cover multiple fields.
diff --git a/source/includes/fact-text-search-legacy-atlas.rst b/source/includes/fact-text-search-legacy-atlas.rst
new file mode 100644
index 00000000000..baf897e6c27
--- /dev/null
+++ b/source/includes/fact-text-search-legacy-atlas.rst
@@ -0,0 +1,3 @@
+MongoDB offers a premium full-text search solution, MongoDB Atlas 
+Search, for MongoDB Atlas users and a legacy text search capability for 
+self-managed deployments. 
\ No newline at end of file
diff --git a/source/text-search.txt b/source/text-search.txt
index 84c07284ce0..8bab8f85642 100644
--- a/source/text-search.txt
+++ b/source/text-search.txt
@@ -10,9 +10,7 @@ Text Search
    :depth: 1
    :class: singlecol
 
-MongoDB offers a premium full-text search solution, MongoDB Atlas 
-Search, for MongoDB Atlas users and a legacy text search capability for 
-self-managed deployments. 
+.. include:: /includes/fact-text-search-legacy-atlas.rst
 
 MongoDB Atlas Search
 --------------------

From f788d4b862e82c60dab432c621bd6f360ede9e4d Mon Sep 17 00:00:00 2001
From: Kanchana Sekhar <kanchana.sekhar@mongodb.com>
Date: Thu, 14 Oct 2021 14:40:19 -0700
Subject: [PATCH 5/6] DOCSP-17260 added link to search and intro to two more
 pages

---
 source/includes/fact-text-search-legacy-atlas.rst | 6 +++---
 source/reference/text-search-languages.txt        | 2 ++
 source/tutorial/text-search-in-aggregation.txt    | 2 ++
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/source/includes/fact-text-search-legacy-atlas.rst b/source/includes/fact-text-search-legacy-atlas.rst
index baf897e6c27..ac1acc261e6 100644
--- a/source/includes/fact-text-search-legacy-atlas.rst
+++ b/source/includes/fact-text-search-legacy-atlas.rst
@@ -1,3 +1,3 @@
-MongoDB offers a premium full-text search solution, MongoDB Atlas 
-Search, for MongoDB Atlas users and a legacy text search capability for 
-self-managed deployments. 
\ No newline at end of file
+MongoDB offers a premium full-text search solution, :atlas:`MongoDB 
+Atlas Search </atlas-search/>`, for MongoDB Atlas users and a legacy 
+text search capability for self-managed deployments. 
\ No newline at end of file
diff --git a/source/reference/text-search-languages.txt b/source/reference/text-search-languages.txt
index 51dbdacf9bf..0e9985df863 100644
--- a/source/reference/text-search-languages.txt
+++ b/source/reference/text-search-languages.txt
@@ -12,6 +12,8 @@ Text Search Languages
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-text-search-legacy-atlas.rst
+
 The :ref:`text index <index-feature-text>` and the :query:`$text`
 operator may be used with the following languages, and accepts either the
 two-letter ISO 639-1 language code or the long form of the
diff --git a/source/tutorial/text-search-in-aggregation.txt b/source/tutorial/text-search-in-aggregation.txt
index c7edb2b65a5..b9f4100cc23 100644
--- a/source/tutorial/text-search-in-aggregation.txt
+++ b/source/tutorial/text-search-in-aggregation.txt
@@ -10,6 +10,8 @@ Text Search in the Aggregation Pipeline
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-text-search-legacy-atlas.rst
+
 .. _text-agg-expression-behavior:
 
 In the aggregation pipeline, text search is available via the use of

From 628ad205a8dca9b64fff492d203255337bf1e843 Mon Sep 17 00:00:00 2001
From: Kanchana Sekhar <kanchana.sekhar@mongodb.com>
Date: Tue, 19 Oct 2021 09:57:30 -0700
Subject: [PATCH 6/6] DOCSP-17260 addressing Jenny's feedback comments

---
 source/includes/fact-atlas-search-languages.rst   | 9 +++++----
 source/includes/fact-text-search-legacy-atlas.rst | 7 ++++---
 source/text-search.txt                            | 4 ++--
 3 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/source/includes/fact-atlas-search-languages.rst b/source/includes/fact-atlas-search-languages.rst
index f0aae591ffd..c2fb77e5446 100644
--- a/source/includes/fact-atlas-search-languages.rst
+++ b/source/includes/fact-atlas-search-languages.rst
@@ -1,4 +1,5 @@
-For data hosted on MongoDB Atlas, :atlas:`Atlas Search </atlas-search>`
-provides support for additional languages. To see the complete list of
-languages supported by Atlas Search, see the :atlas:`Atlas Search
-Language Analyzers </reference/atlas-search/analyzers/language/>`.
+:atlas:`Atlas Search </atlas-search>` also offers common 
+:atlas:`analyzers for parsing text for full-text search 
+</reference/atlas-search/analyzers/>`, including support for over 
+:atlas:`40 language-specific analyzers 
+</reference/atlas-search/analyzers/language/>`.
diff --git a/source/includes/fact-text-search-legacy-atlas.rst b/source/includes/fact-text-search-legacy-atlas.rst
index ac1acc261e6..3df9e7d46f4 100644
--- a/source/includes/fact-text-search-legacy-atlas.rst
+++ b/source/includes/fact-text-search-legacy-atlas.rst
@@ -1,3 +1,4 @@
-MongoDB offers a premium full-text search solution, :atlas:`MongoDB 
-Atlas Search </atlas-search/>`, for MongoDB Atlas users and a legacy 
-text search capability for self-managed deployments. 
\ No newline at end of file
+MongoDB offers a :atlas:`premium full-text search solution, MongoDB 
+Atlas Search </atlas-search/>`, for data hosted on :atlas:`MongoDB 
+Atlas </>`. A legacy text search capability is available for users 
+self-managing MongoDB deployments. 
\ No newline at end of file
diff --git a/source/text-search.txt b/source/text-search.txt
index 8bab8f85642..5718ff45790 100644
--- a/source/text-search.txt
+++ b/source/text-search.txt
@@ -16,8 +16,8 @@ MongoDB Atlas Search
 --------------------
 
 For MongoDB Atlas users, MongoDB's Atlas Search supports fine-grained 
-text indexing using several kinds of text analyzers and searching using 
-a rich query language. To learn more about full-text search indexes and 
+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: 
 
 - :atlas:`Atlas Search Aggregation Pipeline Stages