DOCSP-26256 replaces views-related doc directives (#2092)

jmd-mongo · web-flow · commit e6f9354f99d1 · 2022-11-01T15:29:00.000-04:00
diff --git a/source/includes/extracts-4.4-changes.yaml b/source/includes/extracts-4.4-changes.yaml
@@ -229,7 +229,7 @@ content: |
 
    Starting in MongoDB 4.4, you can specify a :operator:`$natural`
    sort when running a :dbcommand:`find` operation against a
-   :doc:`view </core/views>`.
+   :ref:`view <views-landing-page>`.
 ---
 ref: 4.4-changes-drop-in-progress-indexes
 content: |
diff --git a/source/includes/extracts-projection.yaml b/source/includes/extracts-projection.yaml
@@ -155,13 +155,13 @@ content: |
         - Using the array projection operators :projection:`$elemMatch`,
           :projection:`$slice`, specifies the array element(s) to include,
           thereby excluding those elements that do not meet the
-          expressions. (Not available for :doc:`views </core/views>`.)
+          expressions. (Not available for :ref:`views <views-landing-page>`.)
 
       * - ``<field>: <$meta expression>``
 
         - Using the :expression:`$meta` operator expression, specifies the
           inclusion of available :expression:`per-document metadata
-          <$meta>`. (Not available for :doc:`views </core/views>`.)
+          <$meta>`. (Not available for :ref:`views <views-landing-page>`.)
 
 
       * - ``<field>: <aggregation expression>``
@@ -232,7 +232,7 @@ content: |
         - Using the array projection operators :projection:`$elemMatch`,
           :projection:`$slice`, specifies the array element(s) to include,
           thereby excluding those elements that do not meet the
-          expressions. (Not available for :doc:`views </core/views>`.)
+          expressions. (Not available for :ref:`views <views-landing-page>`.)
 
       * - ``<field>: <aggregation expression>``
 
diff --git a/source/includes/extracts-views.yaml b/source/includes/extracts-views.yaml
@@ -4,20 +4,20 @@ content: |
 ---
 ref: views-unsupported-text-search
 content: |
-   :doc:`Views </core/views>` do not support text search.
+   :ref:`Views <views-landing-page>` do not support text search.
 ---
 ref: views-unsupported-mapReduce
 content: |
-   :doc:`Views </core/views>` do not support map-reduce operations.
+   :ref:`Views <views-landing-page>` do not support map-reduce operations.
 ---
 ref: views-unsupported-rename
 content: |
-   You cannot rename :doc:`views </core/views>`.
+   You cannot rename :ref:`views <views-landing-page>`.
 ---
 ref: views-unsupported-geoNear
 content: |
-   :doc:`Views </core/views>` do not support geoNear operations (i.e.
-   :pipeline:`$geoNear` pipeline stage).
+   :ref:`Views <views-landing-page>` do not support geoNear operations 
+   (specifically, the :pipeline:`$geoNear` pipeline stage).
 ---
 ref: views-unsupported-projection-operators
 content: |
@@ -31,7 +31,7 @@ content: |
 ---
 ref: _views-unsupported-projection
 content: |
-   :method:`db.collection.find()` operations on :doc:`views </core/views>` do not support {{projection}} projection operator.
+   :method:`db.collection.find()` operations on :ref:`views <views-landing-page>` do not support {{projection}} projection operator.
 ---
 ref: views-unsupported-projection-$
 inherit:
diff --git a/source/reference/command/collMod.txt b/source/reference/command/collMod.txt
@@ -238,7 +238,7 @@ Views
 .. collflag:: pipeline
 
    The :ref:`aggregation pipeline <aggregation-pipeline>` that defines
-   the :doc:`view </core/views>`.
+   the :ref:`view <views-landing-page>`.
 
    .. note::
 
diff --git a/source/reference/command/create.txt b/source/reference/command/create.txt
@@ -517,7 +517,7 @@ Create a View
 
 .. include:: /includes/extracts/views-restriction-output-to-disk.rst
 
-To create a :doc:`view </core/views>` using the :dbcommand:`create`
+To create a :ref:`view <views-landing-page>` using the :dbcommand:`create`
 command, use the following syntax:
 
 .. code-block:: javascript
diff --git a/source/reference/command/dbStats.txt b/source/reference/command/dbStats.txt
@@ -117,7 +117,7 @@ Output
 
 .. data:: dbStats.views
 
-   Number of :doc:`views </core/views>` in the database.
+   Number of :ref:`views <views-landing-page>` in the database.
 
 .. data:: dbStats.objects
 
diff --git a/source/reference/command/find.txt b/source/reference/command/find.txt
@@ -86,7 +86,7 @@ The command accepts the following fields:
 
    * - ``find``
      - string
-     - The name of the collection or :doc:`view </core/views>` to query.
+     - The name of the collection or :ref:`view <views-landing-page>` to query.
 
    * - ``filter``
      - document
diff --git a/source/reference/command/listCollections.txt b/source/reference/command/listCollections.txt
@@ -16,7 +16,7 @@ Definition
 .. dbcommand:: listCollections
 
    Retrieve information, i.e. the name and options, about the
-   collections and :doc:`views </core/views>` in a database. Specifically, the command returns a
+   collections and :ref:`views <views-landing-page>` in a database. Specifically, the command returns a
    document that contains information with which to create a
    cursor to the collection information. :binary:`~bin.mongosh`
    provides the :method:`db.getCollectionInfos()` and the
diff --git a/source/reference/log-messages.txt b/source/reference/log-messages.txt
@@ -1484,7 +1484,7 @@ View
 ~~~~
 
 Starting in MongoDB 5.0, :ref:`log messages for slow queries
-<log-message-slow-ops>` on :doc:`views </core/views>` include a
+<log-message-slow-ops>` on :ref:`views <views-landing-page>` include a
 ``resolvedViews`` field that contains the view details:
 
 .. code-block:: javascript
diff --git a/source/reference/method/db.collection.aggregate.txt b/source/reference/method/db.collection.aggregate.txt
@@ -20,7 +20,7 @@ Definition
    .. include:: /includes/fact-mongosh-shell-method-alt.rst
 
 
-   Calculates aggregate values for the data in a collection or a :doc:`view </core/views>`.
+   Calculates aggregate values for the data in a collection or a :ref:`view <views-landing-page>`.
 
    .. list-table::
       :header-rows: 1
diff --git a/source/reference/method/db.collection.drop.txt b/source/reference/method/db.collection.drop.txt
@@ -21,7 +21,7 @@ Definition
    .. include:: /includes/fact-mongosh-shell-method.rst
 
 
-   Removes a collection or :doc:`view </core/views>` from the database.
+   Removes a collection or :ref:`view <views-landing-page>` from the database.
    The method also removes any indexes associated with the dropped
    collection. The method provides a wrapper around the
    :dbcommand:`drop` command.
diff --git a/source/reference/method/db.createCollection.txt b/source/reference/method/db.createCollection.txt
@@ -15,7 +15,7 @@ Definition
 
 .. method:: db.createCollection(name, options)
 
-   Creates a new collection or :doc:`view </core/views>`. For views,
+   Creates a new collection or :ref:`view <views-landing-page>`. For views,
    see also :method:`db.createView()`.
 
    Because MongoDB creates a collection implicitly when the collection
diff --git a/source/reference/method/db.createView.txt b/source/reference/method/db.createView.txt
@@ -14,7 +14,7 @@ db.createView()
 
    .. include:: /includes/views/disambiguate-standard-materialized.rst
 
-   Creates a :doc:`view </core/views>` as the result of the applying
+   Creates a :ref:`view <views-landing-page>` as the result of the applying
    the specified :ref:`aggregation pipeline <aggregation-pipeline>` to
    the source collection or view. Views act as read-only collections,
    and are computed on demand during read operations. You must create
diff --git a/source/reference/method/db.getCollection.txt b/source/reference/method/db.getCollection.txt
@@ -15,7 +15,7 @@ Definition
 
 .. method:: db.getCollection(name)
 
-   Returns a :term:`collection` or a :doc:`view </core/views>` object
+   Returns a :term:`collection` or a :ref:`view <views-landing-page>` object
    that is functionally equivalent to using the ``db.<collectionName>``
    syntax. The method is useful for a collection or a view whose name
    might interact with :binary:`~bin.mongosh` itself, such as names
diff --git a/source/reference/method/db.getCollectionNames.txt b/source/reference/method/db.getCollectionNames.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.getCollectionNames()
 
    Returns an array containing the names of all collections and
-   :doc:`views </core/views>` in the current database, or if running
+   :ref:`views <views-landing-page>` in the current database, or if running
    with access control, the names of the collections according to user's
    privilege. For details, see :ref:`db.collectionnames-access`.
 
diff --git a/source/reference/operator/aggregation/collStats.txt b/source/reference/operator/aggregation/collStats.txt
@@ -127,7 +127,7 @@ Definition
 
     * - ``latencyStats``
       - Statistics related to request latency for a collection or
-        :doc:`view </core/views>`. See :ref:`latency-stats-document`
+        :ref:`view <views-landing-page>`. See :ref:`latency-stats-document`
         for details on this document.
 
         Only present when the ``latencyStats: {}`` option is specified.
@@ -144,7 +144,7 @@ Definition
 
         Only present when the ``storageStats`` option is specified.
 
-        Returns an error if applied to a :doc:`view </core/views>`.
+        Returns an error if applied to a view.
 
     * - ``count``
       - The total number of documents in the collection. This data is
@@ -157,7 +157,7 @@ Definition
            clusters.
 
         Only present when the ``count: {}`` option is specified. Returns
-        an error if applied to a :doc:`view </core/views>`.
+        an error if applied to a view.
 
     * - ``queryExecStats``
       - Statistics related to query execution for the collection. 
@@ -306,7 +306,7 @@ See :ref:`collStats-output` for a reference on this document.
    - :data:`collStats.indexSizes`
 
 Performing ``$collStats`` with the ``storageStats`` option on a
-:doc:`view </core/views>` results in an error.
+view results in an error.
 
 .. _collstat-count:
 
diff --git a/source/reference/operator/aggregation/merge.txt b/source/reference/operator/aggregation/merge.txt
@@ -756,14 +756,14 @@ Restrictions
      - An aggregation pipeline cannot use :pipeline:`$merge` to output to
        a time series collection.
 
-   * - | :doc:`View definition </core/views>`
+   * - | :ref:`view definition <views-landing-page>`
        | *Separate from materialized view*
 
-     - :doc:`View definition </core/views>` cannot include the
-       :pipeline:`$merge` stage. If the view definition includes nested
-       pipeline (for example, the view definition includes
-       :pipeline:`$facet` stage), this :pipeline:`$merge` stage
-       restriction applies to the nested pipelines as well.
+     - A view definition cannot include the :pipeline:`$merge` stage. 
+       If the view definition includes nested pipeline (for example, 
+       the view definition includes :pipeline:`$facet` stage), this 
+       :pipeline:`$merge` stage restriction applies to the nested 
+       pipelines as well.
 
    * - :pipeline:`$lookup` stage
 
diff --git a/source/reference/operator/aggregation/out.txt b/source/reference/operator/aggregation/out.txt
@@ -243,14 +243,13 @@ Restrictions
      - An aggregation pipeline cannot use :pipeline:`$out` to output to
        a time series collection.
 
-   * - :doc:`View definition </core/views>`
+   * - :ref:`view definition <views-landing-page>`
 
      - The :pipeline:`$out` stage is not allowed as part of a
-       :doc:`view definition </core/views>`. If the view definition
-       includes nested pipeline (e.g. the view definition includes
-       :pipeline:`$lookup` or :pipeline:`$facet` stage), this
-       :pipeline:`$out` stage restriction applies to the nested
-       pipelines as well.
+       view definition. If the view definition includes nested pipeline 
+       (e.g. the view definition includes :pipeline:`$lookup` or 
+       :pipeline:`$facet` stage), this :pipeline:`$out` stage 
+       restriction applies to the nested pipelines as well.
 
    * - :pipeline:`$lookup` stage
 
diff --git a/source/reference/system-collections.txt b/source/reference/system-collections.txt
@@ -115,6 +115,6 @@ each database:
 .. data:: <database>.system.views
 
    The :data:`<database>.system.views` collection contains
-   information about each :doc:`view </core/views>` in the database.
+   information about each :ref:`view <views-landing-page>` in the database.
 
    .. include:: /includes/5.0-changes/no-direct-write-system-views.rst
diff --git a/source/release-notes/4.2-compatibility.txt b/source/release-notes/4.2-compatibility.txt
@@ -260,7 +260,7 @@ Aggregation
 ``$out`` and Views
 ``````````````````
 
-The :doc:`view </core/views>` definition ``pipeline`` cannot include
+The :ref:`view <views-landing-page>` definition ``pipeline`` cannot include
 the :pipeline:`$out` stage. If you already have an existing view
 that includes the :pipeline:`$out` stage, you can no longer create
 new views from this existing view.
