Skip to content

Commit d7e819c

Browse files
jeff-allen-mongojeff-allen-mongo
authored
(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
1 parent 61c97c6 commit d7e819c

File tree

10 files changed

+79
-45
lines changed

10 files changed

+79
-45
lines changed

‎source/core/index-text.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ Text Indexes
1212
:depth: 1
1313
:class: singlecol
1414

15+
.. include:: /includes/extracts/fact-text-search-legacy-atlas.rst
16+
1517
Overview
1618
--------
1719

‎source/core/link-text-indexes.txt

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
1-
==============================
2-
Perform a Text Search (Legacy)
3-
==============================
1+
.. _text-search-on-premises:
2+
3+
================================================
4+
Perform a Text Search (Self-Managed Deployments)
5+
================================================
46

57
.. default-domain:: mongodb
68

‎source/core/text-search-operators.txt

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
1-
==============================
2-
Text Search Operators (Legacy)
3-
==============================
1+
.. _text-search-operators-on-premises:
2+
3+
================================================
4+
Text Search Operators (Self-Managed Deployments)
5+
================================================
46

57
.. default-domain:: mongodb
68

@@ -12,10 +14,6 @@ Text Search Operators (Legacy)
1214

1315
.. include:: /includes/fact-text-search-legacy-atlas.rst
1416

15-
.. note::
16-
17-
.. include:: /includes/extracts/views-unsupported-text-search.rst
18-
1917
Query Framework
2018
---------------
2119

‎source/core/text-search/on-prem.txt

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
.. _text-search-on-prem:
2+
3+
=======================================
4+
Text Search on Self-Managed Deployments
5+
=======================================
6+
7+
.. default-domain:: mongodb
8+
9+
.. toctree::
10+
:titlesonly:
11+
12+
/core/link-text-indexes
13+
/core/text-search-operators
14+
/tutorial/text-search-in-aggregation
15+
/reference/text-search-languages

‎source/includes/extracts-atlas-search-facts.yaml

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
ref: fact-text-search-legacy-atlas
22
content: |
33
4-
MongoDB offers a :atlas:`full-text search solution, MongoDB Atlas
5-
Search </atlas-search/>`, for data hosted on :atlas:`MongoDB
6-
Atlas </>`. A legacy text search capability is available for users
7-
self-managing MongoDB deployments.
4+
.. note::
5+
6+
This page describes text search capabilities for self-managed
7+
(non-Atlas) deployments. For data hosted on MongoDB Atlas, MongoDB
8+
offers an improved full-text search solution, :atlas:`Atlas Search
9+
</atlas-search/>`.
810
911
---
1012
ref: fact-regex-search-legacy-atlas

‎source/includes/indexes/text-search-indexes-overview.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
For data hosted on MongoDB Atlas, you can support full-text search with
2+
Atlas Search indexes. To learn more, see :atlas:`Create an Atlas Search
3+
Index </atlas-search/create-index/>`.
4+
5+
For self-managed (non-Atlas) deployments, MongoDB provides a ``text``
6+
index type that supports searching for string content in a collection.
7+
To learn more about self-managed text indexes, see
8+
:ref:`index-feature-text`.

‎source/indexes.txt

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -176,16 +176,10 @@ planar geometry when returning results and :doc:`2dsphere indexes
176176
See :doc:`/core/geospatial-indexes` for a high level introduction to
177177
geospatial indexes.
178178

179-
Text Indexes
180-
~~~~~~~~~~~~
181-
182-
MongoDB provides a ``text`` index type that supports searching
183-
for string content in a collection. These text indexes do not store
184-
language-specific *stop* words (e.g. "the", "a", "or") and *stem* the
185-
words in a collection to only store root words.
179+
Text Search Indexes
180+
~~~~~~~~~~~~~~~~~~~
186181

187-
See :doc:`/core/index-text` for more information on text indexes and
188-
search.
182+
.. include:: /includes/indexes/text-search-indexes-overview.rst
189183

190184
Hashed Indexes
191185
~~~~~~~~~~~~~~

‎source/reference/operator/query/regex.txt

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,16 @@ $regex
1212

1313
.. meta::
1414
:description: pattern matching on strings in MongoDB |version|
15-
:keywords: regex, regular expressions, LIKE queries, wildcard matches, pattern matches, MongoDB |version|, version |version|
15+
:keywords: regex, regular expressions, LIKE queries, wildcard matches, pattern matches, MongoDB |version|, version |version|
16+
17+
.. note::
18+
19+
This page describes regular expression search capabilities for
20+
self-managed (non-Atlas) deployments. For data hosted on MongoDB
21+
Atlas, MongoDB offers an improved full-text search solution,
22+
:atlas:`Atlas Search </atlas-search/>`, which has its own ``$regex``
23+
operator. To learn more, see :atlas:`$regex </atlas-search/regex/>`
24+
in the Atlas Search documentation.
1625

1726
Definition
1827
----------

‎source/text-search.txt

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,19 @@ Text Search
1010
:depth: 1
1111
:class: singlecol
1212

13-
.. include:: /includes/fact-text-search-legacy-atlas.rst
13+
MongoDB provides different text search capabilities depending on whether
14+
your data is hosted on :atlas:`MongoDB Atlas </>` or a self-managed
15+
deployment.
1416

1517
MongoDB Atlas Search
1618
--------------------
1719

18-
For MongoDB Atlas users, MongoDB's Atlas Search supports fine-grained
19-
text indexing and a rich query language for fast, relevant search
20-
results. To learn more about full-text search indexes and
21-
:pipeline:`$search` queries, see:
20+
To perform text search on data hosted on MongoDB Atlas, use
21+
:atlas:`MongoDB Atlas Search </atlas-search>`. Atlas Search supports
22+
fine-grained text indexing and a rich query language for fast, relevant
23+
search results.
24+
25+
To learn more and get started with Atlas Search, see:
2226

2327
- :atlas:`Atlas Search Aggregation Pipeline Stages
2428
</reference/atlas-search/query-syntax/>`
@@ -29,33 +33,29 @@ results. To learn more about full-text search indexes and
2933

3034
.. include:: /includes/fact-atlas-search-languages.rst
3135

32-
Legacy Text Search
33-
------------------
36+
Text Search on Self-Managed Deployments
37+
---------------------------------------
3438

35-
For self-managed deployments, MongoDB's legacy text search capability
36-
supports query operations that perform a text search of string content.
37-
To perform text search, MongoDB uses a :ref:`text index
39+
For self-managed (non-Atlas) deployments, MongoDB's text search
40+
capability supports query operations that perform a text search of
41+
string content. To perform text search, MongoDB uses a :ref:`text index
3842
<index-feature-text>` and the :query:`$text` operator.
3943

4044
.. note::
4145

4246
.. include:: /includes/extracts/views-unsupported-text-search.rst
4347

44-
To learn more about legacy text search for self-managed deployments,
45-
see:
48+
To learn more about text search for self-managed deployments, see:
4649

4750
- :doc:`Text Indexes </core/link-text-indexes/>`
4851
- :doc:`Text Search Operators </core/text-search-operators/>`
4952

50-
MongoDB also supports text search for various languages. See
51-
:doc:`/reference/text-search-languages` for a list of supported
52-
languages.
53+
MongoDB also supports text search for various languages. For a list of
54+
supported languages, see :ref:`text-search-languages`.
5355

5456
.. toctree::
5557
:titlesonly:
5658
:hidden:
57-
58-
/core/link-text-indexes
59-
/core/text-search-operators
60-
/tutorial/text-search-in-aggregation
61-
/reference/text-search-languages
59+
60+
MongoDB Atlas Search <https://www.mongodb.com/docs/atlas/atlas-search/>
61+
/core/text-search/on-prem

‎source/tutorial/create-indexes-to-support-queries.txt

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,8 +88,12 @@ can support all the queries that search a "prefix" subset of those fields.
8888

8989
.. include:: /includes/fact-index-intersection-vs-compound-indexes.rst
9090

91+
Create Indexes to Support Text Search
92+
-------------------------------------
93+
94+
.. include:: /includes/indexes/text-search-indexes-overview.rst
95+
9196
Index Use and Collation
9297
-----------------------
9398

9499
.. include:: /includes/extracts/collation-index-use.rst
95-

0 commit comments

Comments
 (0)