From eae44bea4cd592c4d78424cce3e4a31c44e8bce4 Mon Sep 17 00:00:00 2001 From: Kanchana Sekhar Date: Mon, 25 Oct 2021 10:22:55 -0700 Subject: [PATCH 1/3] DOCSP-19125 Direct Regex Search traffic to Atlas Search --- source/core/link-text-indexes.txt | 2 +- source/core/text-search-operators.txt | 2 +- .../includes/extracts-atlas-search-facts.yaml | 24 +++++++++++++++++++ .../fact-text-search-legacy-atlas.rst | 4 ---- source/reference/operator/query/regex.txt | 4 ++++ source/reference/text-search-languages.txt | 2 +- source/text-search.txt | 2 +- .../tutorial/text-search-in-aggregation.txt | 2 +- 8 files changed, 33 insertions(+), 9 deletions(-) create mode 100644 source/includes/extracts-atlas-search-facts.yaml delete 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 2a3efa4f41e..ac7bb1c7779 100644 --- a/source/core/link-text-indexes.txt +++ b/source/core/link-text-indexes.txt @@ -5,7 +5,7 @@ Perform a Text Search (Legacy) .. default-domain:: mongodb -.. include:: /includes/fact-text-search-legacy-atlas.rst +.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst .. include:: /includes/fact-text-index.rst diff --git a/source/core/text-search-operators.txt b/source/core/text-search-operators.txt index 38cf0ac7339..ef050409541 100644 --- a/source/core/text-search-operators.txt +++ b/source/core/text-search-operators.txt @@ -10,7 +10,7 @@ Text Search Operators (Legacy) :depth: 1 :class: singlecol -.. include:: /includes/fact-text-search-legacy-atlas.rst +.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst .. note:: diff --git a/source/includes/extracts-atlas-search-facts.yaml b/source/includes/extracts-atlas-search-facts.yaml new file mode 100644 index 00000000000..a27f861a247 --- /dev/null +++ b/source/includes/extracts-atlas-search-facts.yaml @@ -0,0 +1,24 @@ +ref: fact-text-search-legacy-atlas +content: | + + MongoDB offers a :atlas:`premium full-text search solution, MongoDB + Atlas Search `, for data hosted on :atlas:`MongoDB + Atlas `. A legacy text search capability is available for users + self-managing MongoDB deployments. + +--- +ref: fact-regex-search-legacy-atlas +content: | + + MongoDB offers a :atlas:`premium full-text search solution, MongoDB + Atlas Search `, for data hosted on :atlas:`MongoDB + Atlas `. If you frequently run case-insensitive regex queries + (utilizing the ``i`` option), we recommend Atlas Search queries that + use the :pipeline:`$search` aggregation pipeline stage. :atlas:`Atlas + Search queries ` significiantly + improve the performance of text queries and offer more options for + customizing query parameters. To learn more, see :atlas:`MongoDB + Atlas Search `. For self-managed deployments, you + can find information on our regex capability below. + +... diff --git a/source/includes/fact-text-search-legacy-atlas.rst b/source/includes/fact-text-search-legacy-atlas.rst deleted file mode 100644 index 3df9e7d46f4..00000000000 --- a/source/includes/fact-text-search-legacy-atlas.rst +++ /dev/null @@ -1,4 +0,0 @@ -MongoDB offers a :atlas:`premium full-text search solution, MongoDB -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/reference/operator/query/regex.txt b/source/reference/operator/query/regex.txt index 0a97ee97115..45a42dcbc5d 100644 --- a/source/reference/operator/query/regex.txt +++ b/source/reference/operator/query/regex.txt @@ -14,6 +14,10 @@ $regex :description: pattern matching on strings in MongoDB |version| :keywords: regex, regular expressions, LIKE queries, wildcard matches, pattern matches, MongoDB |version|, version |version| +.. note:: + + .. include:: /includes/extracts/fact-regex-search-legacy-atlas.rst + Definition ---------- diff --git a/source/reference/text-search-languages.txt b/source/reference/text-search-languages.txt index 0e9985df863..018e42b53ee 100644 --- a/source/reference/text-search-languages.txt +++ b/source/reference/text-search-languages.txt @@ -12,7 +12,7 @@ Text Search Languages :depth: 1 :class: singlecol -.. include:: /includes/fact-text-search-legacy-atlas.rst +.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst The :ref:`text index ` and the :query:`$text` operator may be used with the following languages, and accepts either the diff --git a/source/text-search.txt b/source/text-search.txt index b175f884468..4b741621beb 100644 --- a/source/text-search.txt +++ b/source/text-search.txt @@ -10,7 +10,7 @@ Text Search :depth: 1 :class: singlecol -.. include:: /includes/fact-text-search-legacy-atlas.rst +.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst MongoDB Atlas Search -------------------- diff --git a/source/tutorial/text-search-in-aggregation.txt b/source/tutorial/text-search-in-aggregation.txt index b9f4100cc23..0eea28ee551 100644 --- a/source/tutorial/text-search-in-aggregation.txt +++ b/source/tutorial/text-search-in-aggregation.txt @@ -10,7 +10,7 @@ Text Search in the Aggregation Pipeline :depth: 1 :class: singlecol -.. include:: /includes/fact-text-search-legacy-atlas.rst +.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst .. _text-agg-expression-behavior: From b9c9fa5c404206ce0d77870998b8edc69eccd45e Mon Sep 17 00:00:00 2001 From: Kanchana Sekhar Date: Mon, 1 Nov 2021 14:23:00 -0700 Subject: [PATCH 2/3] DOCSP-19125 updates for copy review feedback --- .../includes/extracts-atlas-search-facts.yaml | 23 +++++++++++-------- source/reference/operator/query/regex.txt | 4 +--- 2 files changed, 14 insertions(+), 13 deletions(-) diff --git a/source/includes/extracts-atlas-search-facts.yaml b/source/includes/extracts-atlas-search-facts.yaml index a27f861a247..89f602141d7 100644 --- a/source/includes/extracts-atlas-search-facts.yaml +++ b/source/includes/extracts-atlas-search-facts.yaml @@ -10,15 +10,18 @@ content: | ref: fact-regex-search-legacy-atlas content: | - MongoDB offers a :atlas:`premium full-text search solution, MongoDB - Atlas Search `, for data hosted on :atlas:`MongoDB - Atlas `. If you frequently run case-insensitive regex queries - (utilizing the ``i`` option), we recommend Atlas Search queries that - use the :pipeline:`$search` aggregation pipeline stage. :atlas:`Atlas - Search queries ` significiantly - improve the performance of text queries and offer more options for - customizing query parameters. To learn more, see :atlas:`MongoDB - Atlas Search `. For self-managed deployments, you - can find information on our regex capability below. + **For data hosted on** :atlas:`MongoDB Atlas `, MongoDB offers a + full-text search solution, :atlas:`MongoDB 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 ` + significiantly improve the performance of text queries and offer more + options for customizing query parameters. To learn more, see + :atlas:`MongoDB Atlas Search `. + + **For self-managed deployments**, you can find information on our + regex capability below. ... diff --git a/source/reference/operator/query/regex.txt b/source/reference/operator/query/regex.txt index 45a42dcbc5d..5e5c60d3a17 100644 --- a/source/reference/operator/query/regex.txt +++ b/source/reference/operator/query/regex.txt @@ -14,9 +14,7 @@ $regex :description: pattern matching on strings in MongoDB |version| :keywords: regex, regular expressions, LIKE queries, wildcard matches, pattern matches, MongoDB |version|, version |version| -.. note:: - - .. include:: /includes/extracts/fact-regex-search-legacy-atlas.rst +.. include:: /includes/extracts/fact-regex-search-legacy-atlas.rst Definition ---------- From 94ae5f1c2c755d0e77ac76912a4ca32bd57aecfa Mon Sep 17 00:00:00 2001 From: Kanchana Sekhar Date: Fri, 5 Nov 2021 08:58:06 -0700 Subject: [PATCH 3/3] DOCSP-19125 2nd round of updates for copy review feedback --- source/includes/extracts-atlas-search-facts.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/includes/extracts-atlas-search-facts.yaml b/source/includes/extracts-atlas-search-facts.yaml index 89f602141d7..8e6dd35b845 100644 --- a/source/includes/extracts-atlas-search-facts.yaml +++ b/source/includes/extracts-atlas-search-facts.yaml @@ -1,8 +1,8 @@ ref: fact-text-search-legacy-atlas content: | - MongoDB offers a :atlas:`premium full-text search solution, MongoDB - Atlas Search `, for data hosted on :atlas:`MongoDB + MongoDB offers a :atlas:`full-text search solution, MongoDB Atlas + Search `, for data hosted on :atlas:`MongoDB Atlas `. A legacy text search capability is available for users self-managing MongoDB deployments. @@ -10,7 +10,7 @@ content: | ref: fact-regex-search-legacy-atlas content: | - **For data hosted on** :atlas:`MongoDB Atlas `, MongoDB offers a + **For data hosted on MongoDB Atlas**, MongoDB offers a full-text search solution, :atlas:`MongoDB Atlas Search `. If you frequently run case-insensitive regex queries (utilizing the ``i`` option), MongoDB recommends Atlas Search