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

* (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

@@ -4,6 +4,12 @@ On-Demand Materialized Views
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
 .. meta::
    :description: MongoDB on-demand materialized view
    :keywords: MongoDB, materialized view
@@ -20,6 +26,86 @@ of completely replacing the collection. This functionality allows users
 to create on-demand materialized views, where the content of the output
 collection can be updated each time the pipeline is run.
 
+
+.. _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

@@ -36,6 +36,13 @@ For example, you can:
   query the joined data without managing or understanding the underlying
   complex pipeline.
 
+.. |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
+
 When clients :ref:`query a view <views-supported-operations>`, MongoDB
 appends the client query to the underlying pipeline and returns the
 results of that combined pipeline to the client. MongoDB may apply

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
 ====================================