DOCS-9103 view definition

Author: kay-kim

source/core/views.txt

@@ -51,6 +51,11 @@ Operations that lists collections, such as
 :method:`db.getCollectionInfos()` and
 :method:`db.getCollectionNames()`, include views in their outputs.
 
+.. important::
+
+   .. include:: /includes/extracts/views-public-definition.rst
+   
+
 Drop a View
 -----------
 

source/includes/apiargs-method-db.createView-param.yaml

@@ -28,6 +28,9 @@ description: |
   An array that consists of the :ref:`aggregation pipeline stage
   <aggregation-pipeline>`.  {{op}} creates the view by
   applying the specified ``pipeline`` to the {{source}}.
+  
+  .. include:: /includes/extracts/views-public-definition.rst
+     
 interface: method
 operation: db.createView
 optional: false

source/includes/extracts-views.yaml

@@ -99,4 +99,11 @@ content: |
    String comparisons on the view use the view's default collation. An
    operation that attempts to change or override a view's default
    collation will fail with an error.
+---
+ref: views-public-definition
+content: |
+   The view definition is public; i.e. :method:`db.getCollectionInfos()`
+   and ``explain`` operations on the view will include the pipeline that
+   defines the view. As such, avoid referring directly to sensitive fields
+   and values in view definitions.
 ...

source/reference/command/create.txt

@@ -110,6 +110,10 @@ The following operation creates a ``managementRatings`` view with the
       pipeline: [ { $project: { "management": "$feedback.management", department: 1 } } ]
    } )
 
+.. important::
+
+   .. include:: /includes/extracts/views-public-definition.rst
+
 .. seealso:: :method:`db.createView()`
 
 .. _create-collation-example:

source/reference/method/db.createView.txt

@@ -44,6 +44,10 @@ db.createView()
    Operations that lists collections, such as
    :method:`db.getCollectionInfos()` and
    :method:`db.getCollectionNames()`, includes views in their outputs.
+   
+   .. important::
+
+      .. include:: /includes/extracts/views-public-definition.rst
 
    To remove a view, use the :method:`~db.collection.drop()` method on the
    view.