From da4fd282b38d1477a433f46c0d16648eb2baa7b2 Mon Sep 17 00:00:00 2001
From: Isabel <76437239+imatwawana@users.noreply.github.com>
Date: Mon, 28 Aug 2023 16:58:29 -0400
Subject: [PATCH] Docs: Add guidance for Dashboard data source in repeating
 rows (#73967)

* Add Dashboard data source guidance

Add guidance about how the special Dashboard data source affects repeating rows

* Update link to repeating rows content

* Fixed broken relrefs and updated wording

* Updated wording for clarity

* Fixed typo
---
 .../build-dashboards/create-dashboard/index.md      | 13 +++++++++++--
 .../configure-panel-options/index.md                |  2 +-
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/sources/dashboards/build-dashboards/create-dashboard/index.md b/docs/sources/dashboards/build-dashboards/create-dashboard/index.md
index d129f72b14c..b534a44ae6b 100644
--- a/docs/sources/dashboards/build-dashboards/create-dashboard/index.md
+++ b/docs/sources/dashboards/build-dashboards/create-dashboard/index.md
@@ -105,9 +105,18 @@ To see an example of repeating rows, refer to [Dashboard with repeating rows](ht
 1. In the **Row Options** dialog box, add a title and select the variable for which you want to add repeating rows.
 1. Click **Update**.
 
-{{% admonition type="note" %}}
 To provide context to dashboard users, add the variable to the row title.
-{{% /admonition %}}
+
+### Repeating rows and the Dashboard special data source
+
+If a row includes panels using the special [Dashboard]({{< relref "../../../datasources/#special-data-sources" >}}) data source&mdash;the data source that uses a result set from another panel in the same dashboard&mdash;then corresponding panels in repeated rows will reference the panel in the original row, not the ones in the repeated rows.
+
+For example, in a dashboard:
+
+- `Row 1` includes `Panel 1A` and `Panel 1B`
+- `Panel 1B` uses the results from `Panel 1A` by way of the `-- Dashboard --` data source
+- Repeating row, `Row 2`, includes `Panel 2A` and `Panel 2B`
+- `Panel 2B` references `Panel 1A`, not `Panel 2A`
 
 ## Move a panel
 
diff --git a/docs/sources/panels-visualizations/configure-panel-options/index.md b/docs/sources/panels-visualizations/configure-panel-options/index.md
index da69bc06113..69cdcaa93bd 100644
--- a/docs/sources/panels-visualizations/configure-panel-options/index.md
+++ b/docs/sources/panels-visualizations/configure-panel-options/index.md
@@ -89,7 +89,7 @@ Explore and export panel, panel data, and data frame JSON models.
 
 ## Configure repeating panels
 
-You can configure Grafana to dynamically add panels or rows to a dashboard. A dynamic panel is a panel that the system creates based on the value of a variable. Variables dynamically change your queries across all panels in a dashboard. For more information about repeating rows, refer to [Configure repeating rows](../add-organize-panels/#configure-repeating-rows).
+You can configure Grafana to dynamically add panels or rows to a dashboard. A dynamic panel is a panel that the system creates based on the value of a variable. Variables dynamically change your queries across all panels in a dashboard. For more information about repeating rows, refer to [Configure repeating rows]({{< relref "../../dashboards/build-dashboards/create-dashboard/#configure-repeating-rows" >}}).
 
 {{% admonition type="note" %}}
 Repeating panels require variables to have one or more items selected; you cannot repeat a panel zero times to hide it.