DOCSP-26575 more information about embedded charts (#684)

Author: kyuan-mongodb

source/embedding-charts.txt

@@ -25,8 +25,21 @@ with an :ref:`iframe <embedding-charts-iframe>`.
 To learn how to embed charts in a web application, see the
 :ref:`embedding-tutorials`.
 
-To learn more, see :ref:`embedded-chart-options` and 
-:ref:`filter-embedded-charts`.
+To learn about what you can do with an embedded chart, see
+:ref:`embedded-chart-options` and :ref:`filter-embedded-charts`.
+
+How Authentication Works
+------------------------
+
+When you visit a webpage with an embedded chart, the :ref:`Embedding
+SDK <embedding-charts-sdk>` sends the chart ID and the user's token to
+|charts|. |charts| then validates the token with an authentication
+provider. 
+
+If the token is valid for the specified chart ID, |charts| executes
+pipelines to the |service| database with any specified injected filters
+and returns the data back to the user's webpage. If the token is
+invalid, the user cannot view the embedded chart.
 
 .. toctree::
    :titlesonly:

source/get-started-embedding.txt

@@ -9,7 +9,40 @@ Get Started with Embedding
 |charts-short| offers a :guilabel:`Getting Started` UI to help you 
 learn how to embed :ref:`charts <embedding-charts>` and 
 :ref:`dashboards <embedding-dashboards>` with an iFrame or Javascript 
-SDK.
+SDK. You can use authenticated or unauthenticated embedding to view
+charts and dashboards generated from your environment.
+
+Authenticated embedding allows you to perform the following actions to
+your charts and dashboards:
+
+- Control user access
+- :ref:`Injected filtering <embedded-chart-options>`
+- :ref:`Google and JWT authentication <configure-auth-providers>`
+
+Unauthenticated embedding allows you to perform the following actions to
+your charts and dashboards: 
+
+- Allow everyone with the chart or dashboard link to have view access
+- Specify the following options:
+
+  - Maximum data range
+  - Auto-refresh
+  - Color theme, width, and height
+  - Whether to display the title and description
+
+.. tip::
+   
+   If you use the :ref:`Embedding SDK <embedding-charts-sdk>`, you can
+   make more flexible adjustments to dashboard settings and rendering
+   specifications such as styling and branding. To learn more, see 
+   :ref:`charts-embedding-sdk`.
+
+Prerequisites
+-------------
+
+- You must be a chart or dashboard :ref:`Author <dashboard-permissions>`
+  to enable embedding for a chart or dashboard.
+- Access to the :ref:`data source <data-sources>`.
 
 Use the Getting Started UI
 --------------------------