DOCSP-27087 adding add pipeline text view section (#446)

* DOCSP-27087 adding add pipeline text view section

* add preview note

* indent

* image

* stage view yaml content

* png

* figwidth

* figwidth all

* enhance

* image name

* image update

* remove warning

* bold

* guilabel

* update

* -

* codeblock

* update image

* build errors

* indent

* Internal review feedback1

* line break

* add create aggregation pipeline blurb

* capatilize

* Internal feedback 2

* pipeline preview expand

* update picture

* figure update

* screenshot blackbar

Author: ianf-mongodb

source/aggregation-pipeline-builder.txt

@@ -73,8 +73,70 @@ Limitations
 Create an Aggregation Pipeline
 ------------------------------
 
+Aggregation pipelines can be created in two seperate modes:
+
+- Stage View Mode, a visual click-based pipeline editor that 
+  preloads pipeline syntax based on your selected stages.
+
+- Text View Mode, a text-based pipeline editor that accepts raw
+  pipeline syntax. 
+
+.. _create-agg-pipeline-stageview:
+
+Stage View Mode
+~~~~~~~~~~~~~~~
+|
+
 .. include:: /includes/steps/create-agg-pipeline.rst
 
+.. _create-agg-pipeline-textview:
+
+Text View Mode
+~~~~~~~~~~~~~~
+|
+
+.. procedure::
+   :style: normal
+
+   .. step:: In the aggregation pipeline pane, click the 
+      :guilabel:`</> Text` toggle switch to enable text mode for 
+      pipeline editing.
+
+      .. figure:: /images/compass/agg-builder-textview-toggle-on.png
+         :alt: Toggle textmode on
+
+   .. step:: Enter valid aggregation syntax in the text editor. 
+      The following example pipeline limits the query results to ``4`` 
+      documents.
+
+      .. code-block:: javascript
+
+         [ { "$limit" : 4 } ]
+
+      .. figure:: /images/compass/agg-builder-textview-edit.png
+         :alt: Edit the text aggregation pipeline
+
+   .. step:: **(Optional)** If preview mode is enabled, you can 
+      click :guilabel:`Output Options` in the Pipeline Output pane to 
+      expand all nested fields and documents within the 
+      preview results.
+
+      .. figure:: /images/compass/agg-builder-textview-expand-pipeline-preview.png
+         :alt: Pipeline Output preview
+
+   .. step:: Click :guilabel:`Run` at the top right of the pipeline builder. 
+      |compass-short| returns your results in the document view.
+
+      .. figure:: /images/compass/agg-builder-textview-agg-results.png
+         :alt: Results after Running Aggregation
+
+   .. step:: **(Optional)** Click the :guilabel:`Output Options` dropdown 
+      and select :guilabel:`Expand all fields` to expand all nested 
+      fields and documents within the query results.
+
+      .. figure:: /images/compass/agg-builder-textview-expand-results.png
+         :alt: Expand the aggregation pipeline results
+
 .. _save-agg-pipeline:
 
 Save a Pipeline

source/images/compass/agg-builder-stageview-toggle-on.png

@@ -1,3 +1,14 @@
+title: Toggle Stage View Mode
+level: 4
+ref: select-stage-view-mode
+content: |
+
+   In the aggregation pipeline pane, ensure the  
+   :guilabel:`{} Stages` toggle switch is selected:
+
+   .. figure:: /images/compass/agg-builder-stageview-toggle-on.png
+      :alt: Toggle on stage view mode 
+---
 title: Add an aggregation pipeline stage.
 level: 4
 ref: add-pipeline-stage