DOCSP-38013 remove self referencing links page (#6958) (#6995)

* DOCSP-38013-Remove-self-referencing-links--page

* Converting additional self-referential query directives to monospace.

* Editorial per feedback.

Author: mmaville-mdb

source/includes/fact-hint-text-query-restriction.rst

@@ -1,4 +1,4 @@
 .. hint-and-text-query
 
-If a query includes a :query:`$text` expression, you cannot use
+If a query includes a ``$text`` expression, you cannot use
 :method:`~cursor.hint()` to specify which index to use for the query.

source/includes/fact-natural-sort-order-text-query-restriction.rst

@@ -1,2 +1,2 @@
 You cannot specify :operator:`$natural` sort order if the query
-includes a :query:`$text` expression.
+includes a ``$text`` expression.

source/includes/fact-text-search-phrase-and-term.rst

@@ -1,3 +1,3 @@
-If the ``$search`` string of a :query:`$text` operation includes a phrase and 
+If the ``$search`` string of a ``$text`` operation includes a phrase and 
 individual terms, text search only matches the documents that include the 
 phrase.

source/includes/fact-text-search-score.rst

@@ -1,8 +1,8 @@
-The :query:`$text` operator assigns a score to each document that
+The ``$text`` operator assigns a score to each document that
 contains the search term in the indexed fields. The score represents
 the relevance of a document to a given text search query. The score can
 be part of a |sort-object| specification as well as part of the
 projection expression. The ``{ $meta: "textScore" }`` expression
-provides information on the processing of the :query:`$text` operation.
+provides information on the processing of the ``$text`` operation.
 See |meta-object| for details on accessing the score for
 projection or sort.

source/includes/list-text-search-restrictions-in-agg.rst

@@ -1,9 +1,9 @@
-- The :pipeline:`$match` stage that includes a :query:`$text` must be
+- The :pipeline:`$match` stage that includes a ``$text`` must be
   the **first** stage in the pipeline.
 
-- A :query:`$text` operator can only occur once in the stage.
+- A ``$text`` operator can only occur once in the stage.
 
-- The :query:`$text` operator expression cannot appear in
+- The ``$text`` operator expression cannot appear in
   :expression:`$or` or :expression:`$not` expressions.
 
 - The text search, by default, does not return the matching documents

source/reference/operator/query/text.txt

@@ -19,14 +19,14 @@ $text
 
 .. include:: /includes/extracts/fact-text-search-legacy-atlas.rst
 
-This page describes :query:`$text` operator for self-managed deployments.
+This page describes the ``$text`` operator for self-managed deployments.
 
 Definition
 ----------
 
 .. query:: $text
 
-   :query:`$text` performs a text search on the content of the fields
+   ``$text`` performs a text search on the content of the fields
    indexed with a :ref:`text index <index-type-text>`. 
 
 Compatibility
@@ -39,7 +39,7 @@ Compatibility
 Syntax
 ------
 
-A :query:`$text` expression has the following syntax:
+A ``$text`` expression has the following syntax:
 
 .. code-block:: javascript
 
@@ -52,7 +52,7 @@ A :query:`$text` expression has the following syntax:
      }
    }
 
-The :query:`$text` operator accepts a text query document with the
+The ``$text`` operator accepts a text query document with the
 following fields:
 
 .. |object-behavior| replace:: :ref:`text-query-operator-behavior`
@@ -107,7 +107,7 @@ following fields:
 
        For more information, see :ref:`text-operator-diacritic-sensitivity`.
 
-The :query:`$text` operator, by default, does *not* return results
+The ``$text`` operator, by default, does *not* return results
 sorted in terms of the results' scores. For more information on
 sorting by the text search scores, see the
 :ref:`text-operator-text-score` documentation.
@@ -120,52 +120,52 @@ Behavior
 Restrictions
 ~~~~~~~~~~~~
 
-- A query can specify, at most, one :query:`$text` expression.
+- A query can specify, at most, one ``$text`` expression.
 
-- The :query:`$text` query can not appear in :query:`$nor` expressions.
+- The ``$text`` query can not appear in :query:`$nor` expressions.
 
-- The :query:`$text` query can not appear in :query:`$elemMatch` query
+- The ``$text`` query can not appear in :query:`$elemMatch` query
   expressions or :projection:`$elemMatch` projection expressions.
 
-- To use a :query:`$text` query in an :query:`$or` expression, all
+- To use a ``$text`` query in an :query:`$or` expression, all
   clauses in the :query:`$or` array must be indexed.
 
 - .. include:: /includes/fact-hint-text-query-restriction.rst
 
 - .. include:: /includes/fact-natural-sort-order-text-query-restriction.rst
 
-  .. |operation| replace:: :query:`$text` expression
+  .. |operation| replace:: ``$text`` expression
 
 - .. include:: /includes/fact-special-indexes-and-text.rst
 
 - .. include:: /includes/extracts/views-unsupported-text-search.rst
 
-- :query:`$text` is unsupported for creating indexes using the
+- ``$text`` is unsupported for creating indexes using the
   :ref:`Stable API <stable-api>` V1.
 
-If using the :query:`$text` operator in aggregation, the following
+If using the ``$text`` operator in aggregation, the following
 restrictions also apply.
 
 .. include:: /includes/list-text-search-restrictions-in-agg.rst
 
-.. |text-object| replace:: :query:`$text`
+.. |text-object| replace:: ``$text``
 .. |meta-object| replace:: :expression:`$meta` projection operator
 .. |sort-object| replace:: :method:`~cursor.sort()` method
 
 ``$search`` Field
 ~~~~~~~~~~~~~~~~~
 
 In the ``$search`` field, specify a string of words that the
-:query:`$text` operator parses and uses to query the :ref:`text index
+``$text`` operator parses and uses to query the :ref:`text index
 <index-type-text>`.
 
-The :query:`$text` operator treats most punctuation
+The ``$text`` operator treats most punctuation
 in the string as delimiters, except a hyphen-minus (``-``) that negates term or
 an escaped double quotes ``\"`` that specifies a phrase.
 
 .. note::
 
-   The ``$search`` field for the :query:`$text` expression is different
+   The ``$search`` field for the ``$text`` expression is different
    than the :atlas:`$search aggregation stage
    </reference/atlas-search/query-syntax/>` provided by
    :atlas:`Atlas Search </atlas-search>`. The ``$search`` aggregation
@@ -192,7 +192,7 @@ For example, passed a ``$search`` string:
 
    "\"ssl certificate\" authority key"
 
-The :query:`$text` operator searches for the phrase ``"ssl
+The ``$text`` operator searches for the phrase ``"ssl
 certificate"``.
 
 .. note:: 
@@ -213,12 +213,12 @@ Prefixing a word with a hyphen-minus (``-``) negates a word:
   search will not match any documents.
 
 - A hyphenated word, such as ``pre-market``, is not a negation. If used
-  in a hyphenated word, :query:`$text` operator treats the hyphen-minus
+  in a hyphenated word, the ``$text`` operator treats the hyphen-minus
   (``-``) as a delimiter. To negate the word ``market`` in this
   instance, include a space between ``pre`` and ``-market``, i.e.,
   ``pre -market``.
 
-The :query:`$text` operator adds all negations to the query with the
+The ``$text`` operator adds all negations to the query with the
 logical ``AND`` operator.
 
 Match Operation
@@ -227,7 +227,7 @@ Match Operation
 Stop Words
 ``````````
 
-The :query:`$text` operator ignores language-specific stop words, such
+The ``$text`` operator ignores language-specific stop words, such
 as ``the`` and ``and`` in English.
 
 .. _match-operation-stemmed-words:
@@ -236,7 +236,7 @@ Stemmed Words
 `````````````
 
 For case insensitive and diacritic insensitive text searches, the
-:query:`$text` operator matches on the complete *stemmed* word. So if a
+``$text`` operator matches on the complete *stemmed* word. So if a
 document field contains the word ``blueberry``, a search on the term
 ``blue`` will not match. However, ``blueberry`` or ``blueberries`` will
 match.
@@ -248,7 +248,7 @@ Case Sensitive Search and Stemmed Words
 
 For :ref:`case sensitive <text-operator-case-sensitivity>` search (i.e.
 ``$caseSensitive: true``), if the suffix stem contains uppercase
-letters, the :query:`$text` operator matches on the exact word.
+letters, the ``$text`` operator matches on the exact word.
 
 .. _diacritic-sensitivity-and-stemming:
 
@@ -257,15 +257,15 @@ Diacritic Sensitive Search and Stemmed Words
 
 For :ref:`diacritic sensitive <text-operator-diacritic-sensitivity>`
 search (i.e. ``$diacriticSensitive: true``), if the suffix stem
-contains the diacritic mark or marks, the :query:`$text` operator
+contains the diacritic mark or marks, the ``$text`` operator
 matches on the exact word.
 
 .. _text-operator-case-sensitivity:
 
 Case Insensitivity
 ~~~~~~~~~~~~~~~~~~
 
-The :query:`$text` operator defaults to the case insensitivity of the
+The ``$text`` operator defaults to the case insensitivity of the
 :ref:`text <index-type-text>` index:
 
 - The version 3 :ref:`text index <text-index-case-insensitivity>` is
@@ -286,19 +286,19 @@ Case Sensitive Search Process
 `````````````````````````````
 
 When performing a case sensitive search (``$caseSensitive: true``)
-where the ``text`` index is case insensitive, the :query:`$text`
+where the ``text`` index is case insensitive, the ``$text``
 operator:
 
 - First searches the ``text`` index for case insensitive and diacritic
   matches.
 
 - Then, to return just the documents that match the case of the search
-  terms, the :query:`$text` query operation includes an additional
+  terms, the ``$text`` query operation includes an additional
   stage to filter out the documents that do not match the specified
   case.
 
 For case sensitive search (i.e. ``$caseSensitive: true``), if
-the suffix stem contains uppercase letters, the :query:`$text` operator
+the suffix stem contains uppercase letters, the ``$text`` operator
 matches on the exact word.
 
 Specifying ``$caseSensitive: true`` may impact performance.
@@ -312,7 +312,7 @@ Specifying ``$caseSensitive: true`` may impact performance.
 Diacritic Insensitivity
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-The :query:`$text` operator defaults to the diacritic insensitivity of
+The ``$text`` operator defaults to the diacritic insensitivity of
 the :ref:`text <index-type-text>` index:
 
 - The version 3 :ref:`text index <text-index-diacritic-insensitivity>` is
@@ -330,30 +330,30 @@ specify ``$diacriticSensitive: true``.
 
 Text searches against earlier versions of the ``text`` index are
 inherently diacritic sensitive and cannot be diacritic insensitive.  As
-such, the ``$diacriticSensitive`` option for the :query:`$text`
+such, the ``$diacriticSensitive`` option for the ``$text``
 operator has no effect with earlier versions of the ``text`` index.
 
 Diacritic Sensitive Search Process
 ``````````````````````````````````
 
 To perform a diacritic sensitive text search (``$diacriticSensitive:
-true``) against a version 3 ``text`` index, the :query:`$text` operator:
+true``) against a version 3 ``text`` index, the ``$text`` operator:
 
 - First searches the ``text`` index, which is diacritic insensitive.
 
 - Then, to return just the documents that match the diacritic marked
-  characters of the search terms, the :query:`$text` query operation
+  characters of the search terms, the ``$text`` query operation
   includes an additional stage to filter out the documents that do not
   match.
 
 Specifying ``$diacriticSensitive: true`` may impact performance.
 
 To perform a diacritic sensitive search against an earlier version of
-the ``text`` index, the :query:`$text` operator searches the ``text``
+the ``text`` index, the ``$text`` operator searches the ``text``
 index, which is diacritic sensitive.
 
 For diacritic sensitive search, if the suffix stem contains the
-diacritic mark or marks, the :query:`$text` operator matches on the
+diacritic mark or marks, the ``$text`` operator matches on the
 exact word.
 
 .. seealso::
@@ -422,7 +422,7 @@ the word:
 Match Any of the Search Terms
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If the search string is a space-delimited string, :query:`$text`
+If the search string is a space-delimited string, the ``$text``
 operator performs a logical ``OR`` search on each term and returns
 documents that contains any of the terms.
 
@@ -496,7 +496,7 @@ Exclude Documents That Contain a Term
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 A *negated* term is a term that is prefixed by a minus sign ``-``. If
-you negate a term, the :query:`$text` operator will exclude the
+you negate a term, the ``$text`` operator will exclude the
 documents that contain those terms from the results.
 
 The following example searches for documents that contain the words
@@ -522,7 +522,7 @@ The query returns the following documents:
 Search a Different Language
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use the optional ``$language`` field in the :query:`$text` expression
+Use the optional ``$language`` field in the ``$text`` expression
 to specify a language that determines the list of stop words and the
 rules for the stemmer and tokenizer for the search string.
 
@@ -544,7 +544,7 @@ The query returns the following documents:
    { "_id" : 5, "subject" : "Café Con Leche", "author" : "abc", "views" : 200 }
    { "_id" : 8, "subject" : "Cafe con Leche", "author" : "xyz", "views" : 10 }
 
-The :query:`$text` expression can also accept the language by name,
+The ``$text`` expression can also accept the language by name,
 ``spanish``. See :ref:`text-search-languages` for the supported
 languages.
 
@@ -555,7 +555,7 @@ languages.
 Case and Diacritic Insensitive Search
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The :query:`$text` operator defers to the case and diacritic
+The ``$text`` operator defers to the case and diacritic
 insensitivity of the ``text`` index. The version 3 ``text`` index is
 diacritic insensitive and expands its case insensitivity to include the
 Cyrillic alphabet as well as characters with diacritics. For details,
@@ -645,7 +645,7 @@ Case Sensitivity with Negated Term
 ``````````````````````````````````
 
 A *negated* term is a term that is prefixed by a minus sign ``-``. If
-you negate a term, the :query:`$text` operator will exclude the
+you negate a term, the ``$text`` operator will exclude the
 documents that contain those terms from the results. You can also
 specify case sensitivity for negated terms.
 
@@ -703,7 +703,7 @@ Diacritic Sensitivity with Negated Term
 
 The ``$diacriticSensitive`` option applies also to negated terms. A
 negated term is a term that is prefixed by a minus sign ``-``. If you
-negate a term, the :query:`$text` operator will exclude the documents that
+negate a term, the ``$text`` operator will exclude the documents that
 contain those terms from the results.
 
 The following query performs a diacritic sensitive text search for