(DOCSP-25295) Adds Edit a Chart's Data Source section for link from UI (#557)

* (DOCSP-25295) Adds Edit a Chart's Data Source section for link from UI

* Adds space to end of include file

Author: sarahsimpers

source/build-charts.txt

@@ -15,7 +15,9 @@ Build Charts
 Charts provide visual representations of the data in your
 :doc:`data source <data-sources>`. A chart maps to a *single*
 data source, and can display correlations between several fields in the
-data. Charts reside inside :doc:`dashboards </dashboards>`. You must create a :doc:`dashboard </dashboards>` before you can begin building charts.
+data. Charts reside inside :doc:`dashboards </dashboards>`. You must
+create a :doc:`dashboard </dashboards>` before you can begin building
+charts.
 
 For a complete list of available chart types and how to build specific
 charts, refer to the :ref:`Chart Types <chart-type-reference>` page.

source/data-sources.txt

@@ -43,6 +43,35 @@ Manage Deployments
 To manage settings for the |service| deployments that contain your data
 sources, see :ref:`manage-deployment`.
 
+.. _edit-data-source:
+
+Edit a Chart's Data Source
+--------------------------
+
+To edit the data source for an existing chart:
+
+.. procedure::
+   :style: normal
+   
+   .. step:: Select your dashboard. 
+      
+      From the :guilabel:`Dashboards` page, select the dashboard that
+      contains the chart.
+      
+   .. step:: Click :guilabel:`Edit` on the chart you want to edit.
+      
+   .. step:: Click the button under :guilabel:`Data Source` on the top left of the chart builder. 
+      
+      The button says :guilabel:`Select` if you have not selected a
+      data source, or it says the name of the currently selected data
+      source.
+
+   .. include:: /includes/select-data-source.rst
+
+
+To learn how to set the data source for a new chart,
+see :doc:`Build Charts <build-charts>`.
+
 .. _charts-sample-data:
 
 Try Out |charts-short| with the Sample Data Source

source/includes/select-data-source.rst

@@ -0,0 +1,23 @@
+.. step:: Click the :guilabel:`Project` tab.
+  
+   All of your connected deployments appear. 
+   
+   .. note::
+
+      A deployment and its data sources won't display on the
+      :guilabel:`Select Data Source`
+      modal unless they are connected to |charts-short|. Only a
+      :authrole:`Project Owner` can :ref:`connect or disconnect
+      <connect-disconnect-data-source>` deployments and data sources.
+      All deployments and data sources in the project connect to 
+      |charts-short| by default.
+
+.. step:: Click the name of the deployment that contains the data source.
+
+.. step:: Click the name of the database that contains the data source.
+  
+   The database's data sources appear. You can click on a data source's
+   name to view a preview of its data.
+
+.. step:: Click :guilabel:`Select` on the data source.
+

source/manage-dashboards.txt

@@ -125,8 +125,11 @@ Edit a Chart
 ~~~~~~~~~~~~
 
 To edit a chart, hover over the desired chart and click the
-:guilabel:`Edit` button. For details on the available editing options,
-see :doc:`Build Charts <build-charts>`.
+:guilabel:`Edit` button. 
+
+To learn how to edit a chart's data source, see
+:ref:`edit-data-source`. To learn how to set the data source for a new
+chart, see :doc:`Build Charts <build-charts>`.
 
 .. _dashboard-remove-chart: