(DOCSP-32324) Adds info on how to create a view in the Atlas UI (#4872) (#4966)

* (DOCSP-32324) Adds info on how to create a view in the Atlas UI

* Moves content to the Materialized View page

* Includes copy review changes

* Includes copy review change

Author: sarahsimpers

source/core/materialized-views.txt

@@ -9,7 +9,7 @@ On-Demand Materialized Views
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 2
+   :depth: 1
    :class: singlecol
 
 .. meta::
@@ -36,6 +36,86 @@ Comparison with Standard Views
 
 .. include:: /includes/views/fact-compare-view-and-materialized-view.rst
 
+
+.. _create-view-atlas:
+
+Create a Materialized View in the {+atlas+} UI 
+-------------------------------------------------------
+
+The example in this section uses the :atlas:`sample movies dataset 
+</sample-data/sample-mflix/>`. To learn how to load the sample dataset 
+into your {+atlas+} deployment, see :atlas:`Load Sample Data 
+</sample-data/#std-label-load-sample-data>`.
+
+To create a materialized view in the {+atlas+} UI, follow these
+steps:
+
+.. procedure:: 
+   :style: normal
+
+   .. step:: Navigate to the collection
+
+      a. In the {+atlas+} UI, click :guilabel:`Database` in the sidebar.
+      #. For the database deployment that contains the sample data,
+         click :guilabel:`Browse Collections`.
+      #. In the left navigation pane, select the
+         :guilabel:`sample_training` database.
+      #. Select the :guilabel:`grades` collection.
+
+   .. step:: Click the :guilabel:`Aggregation` tab
+
+   .. step:: Click :guilabel:`Add Stage`
+
+   .. step:: Select an aggregation stage from the :guilabel:`Select` drop-down menu
+
+      The aggregation stage transforms the data that you want to save as
+      a view. To learn more about available aggregation stages, see 
+      :ref:`agg-pipeline-quick-ref`.
+
+      For this example, add a new field with the :pipeline:`$set` stage:
+
+      a. Select :pipeline:`$set` from the :guilabel:`Select` drop-down
+         menu.
+      #. Add the following syntax to the aggregation pipeline 
+         editor to create an average score across all ``score``
+         values in the ``scores`` array within the ``grades``
+         collection:
+
+         .. code-block::
+
+            {
+              averageScore: { $avg: "$scores.score" }
+            }
+
+         {+atlas+} adds the ``averageScore`` value to each document.
+
+   .. step:: Click :guilabel:`Add Stage`
+
+   .. step:: Add the ``$out`` stage
+      
+      a. Select the :pipeline:`$out` stage from the :guilabel:`Select` 
+         drop-down menu.
+      #. Add the following syntax to the aggregation pipeline
+         to write the results of the pipeline to the ``myView``
+         collection in the ``sample_training`` database:
+
+         .. code-block::
+
+            'myView'
+
+      #. Click :guilabel:`Save Documents`.
+
+      The :pipeline:`$out` stage writes the results of the
+      aggregation pipeline to the specified collection, which creates
+      the view. To learn more, see :pipeline:`$out`.
+
+      Refresh the list of collections to see the ``myView`` collection.
+
+      To learn how to query the ``myView`` collection in the {+atlas+}
+      UI, see :atlas:`View, Filter, and Sort Documents 
+      </atlas-ui/documents/#view--filter--and-sort-documents>` in the
+      {+atlas+} documentation.
+
 Example
 -------
 

source/core/views.txt

@@ -21,6 +21,13 @@ computed on-demand when a client queries the view.
 
 .. include:: /includes/views/disambiguate-standard-materialized.rst
 
+.. |page-topic| replace:: create views
+.. |link-topic-ing| replace:: creating materialized views in the UI
+.. |atlas-url| replace:: :ref:`create-view-atlas`
+
+.. include:: /includes/fact-atlas-compatible.rst
+.. include:: /includes/fact-atlas-link.rst
+
 Use Cases
 ---------
 
@@ -42,8 +49,9 @@ You can use views to:
 Create and Manage Views
 -----------------------
 
-To learn how to create and manage views, see the following pages:
+To learn how to create and manage views, see the following resources:
 
+- :ref:`create-view-atlas`
 - :ref:`manual-views-create`
 - :ref:`manual-views-lookup`
 - :ref:`manual-views-collation`

source/core/views/create-view.txt

@@ -12,8 +12,13 @@ Create and Query a View
    :depth: 2
    :class: singlecol
 
-To create a view, use :method:`db.createCollection()` or
-:method:`db.createView()`.
+To create a view, use one of the following methods:
+
+- Use :method:`db.createCollection()`
+- Use :method:`db.createView()`
+
+To create a view in the {+atlas+} UI, you must use a materialized
+view. To learn more, see :ref:`create-view-atlas`.
 
 .. important:: View Names are Included in Collection List Output
 

source/meta/aggregation-quick-reference.txt

@@ -3,6 +3,8 @@
    with slight difference. Quick Reference contains information on different expressions,
    such as field paths, expression objects, etc.
 
+.. _agg-pipeline-quick-ref:
+
 ====================================
 Aggregation Pipeline Quick Reference
 ====================================