DOCSP-33097 nlc experimental feature (#627)

* nlc experimental feature

Author: kyuan-mongodb

snooty.toml

@@ -23,7 +23,8 @@ toc_landing_pages = ["/installation", "/dashboards",
                      "/embedding-tutorials",
                      "/embedding-charts-sdk",
                      "/manage-data-sources",
-                     "/bin-data", "/encoding-channels"]
+                     "/bin-data", "/encoding-channels", 
+                     "/experimental-features"]
 
 [constants]
 version = "v0.10.0"
@@ -62,3 +63,16 @@ css = ":abbr:`CSS (Cascading Style Sheets)`"
 pdf = ":abbr:`PDF (Portable Document Format)`"
 png = ":abbr:`PNG (Portable Network Graphic)`"
 iot = ":abbr:`IoT (Internet of Things)`"
+
+[[banners]]
+# NLC in public preview
+targets = [
+    "index.txt",
+    "chart-types.txt",
+    "chart-type-reference/*.txt"
+]
+
+variant = "warning"
+value = """
+        Natural Language Charts is available as a Preview feature. The feature and the corresponding documentation might change at any time during the Preview period.
+        """

source/experimental-features.txt

@@ -0,0 +1,121 @@
+.. _charts-experimental-features:
+
+=====================
+Experimental Features
+=====================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+This page lists |charts| current preview features. A preview feature is
+when a |charts| feature is available for evaluation purpose and not
+recommended for production deployments. The feature and its
+corresponding documentation can change at any time.
+
+Natural Language Charts
+-----------------------
+
+Natural language charts simplifies the chart creation process. After you
+enter a prompt about a chart you would like to see, the AI model
+creates the chart.
+
+To use this feature, you can sign up at :website:`the MongoDB Charts product page </products/charts>`.
+
+To learn more, see :website:`New Intelligent Developer Experiences
+Compass Atlas Charts Relational Migrator
+</blog/post/new-intelligent-developer-experiences-compass-atlas-charts-relational-migrator>`.
+
+Limitations
+~~~~~~~~~~~
+
+Natural language charts only supports grouped bar charts,
+:ref:`single-series charts <single-series-multiple-fields>`, and
+:ref:`multi-series charts <multi-series-charts>` built with :ref:`series
+<charts-series-encoding>` and :ref:`aggregation
+<building-charts-aggregation>` :ref:`encoding channels
+<encoding-channels>`.
+
+Natural language charts do not support :ref:`filtering
+<dashboard-filtering>`, :ref:`sorting <charts-sort-data>`, :ref:`binning
+<charts-bin-data>`, or :ref:`limiting <charts-limit-data>`.
+
+Procedure
+~~~~~~~~~
+
+.. procedure:: 
+   :style: normal 
+
+   .. step:: Add a natural language chart. 
+
+      .. procedure::
+         :style: connected
+
+         .. step:: From the :guilabel:`Dashboards` page, select the dashboard 
+            where you want to add a new chart. For instructions on setting 
+            up a dashboard, see :doc:`Dashboards </dashboards>`.
+
+         .. step:: Click the :guilabel:`Add Chart` button.
+
+         .. step:: In the :guilabel:`Select Data Source` modal, click the 
+            :guilabel:`Project` tab. 
+
+         .. step:: In the cluster where you loaded the 
+            sample data, select the ``listingsAndReviews`` collection 
+            in the ``sample_airbnb`` database.
+
+         .. step:: Toggle the switch on the top navigation from :guilabel:`Classic` to :guilabel:`Natural Language`.
+
+            When you toggle this, you must click the :guilabel:`Use
+            Natural Language Mode` button in the :guilabel:`Natural
+            Language Mode` modal to accept the `MongoDB Acceptable
+            Use Policy
+            <https://www.mongodb.com/legal/acceptable-use-policy>`__ and
+            `Privacy Policy
+            <https://www.mongodb.com/legal/privacy-policy>`__.
+
+            .. figure:: /images/charts/nl-mode-modal.png
+               :figwidth: 300px
+               :alt: Natural Language Mode Modal
+
+            If you click :guilabel:`Back to Classic Mode`, |charts|
+            switches you back to :guilabel:`Classic` mode.
+
+   .. step:: Describe the chart you want to create.
+
+      In the :guilabel:`Prompt` box, specify the chart you want |charts|
+      to create.
+
+      .. note::
+
+         Your prompt cannot exceed 500 characters.
+
+      If you're unsure of what chart you would like to see, you can
+      choose one of the :guilabel:`Suggested Prompts` and click
+      :guilabel:`Select`.
+
+      .. tip:: 
+         
+         If your :guilabel:`Suggested Prompts` section does not load,
+         click :guilabel:`Retry`.
+
+         .. figure:: /images/charts/nlc-suggested-prompts.png
+            :figwidth: 508px
+            :alt: Natural Language Charts Suggested Prompts Load Error
+
+   .. step:: Click :guilabel:`Generate chart`.
+       
+      |charts| displays your chart and also generates a title based 
+      on your prompt.
+    
+   .. step:: (Optional) Customize your chart.
+       
+      To :ref:`customize your chart <customize-charts>`, toggle the
+      switch on the top navigation from :guilabel:`Natural Language`
+      to :guilabel:`Classic`.
+
+   .. step:: Click :guilabel:`Save and Close`.

source/images/charts/nl-mode-modal.png

@@ -122,3 +122,4 @@ data and explore key features offered by |charts|:
    /pricing
    /release-notes
    /third-party-licenses
+   /experimental-features