From e5ff56ae7b361d95be0de2f086f876b24e6a1b49 Mon Sep 17 00:00:00 2001 From: Christopher Moyer <35463610+chri2547@users.noreply.github.com> Date: Wed, 26 Mar 2025 16:58:47 -0500 Subject: [PATCH] docs/adds shared shortcode (#102946) * adds shared shortcode * makes prettier --- docs/sources/dashboards/_index.md | 4 ++++ .../dashboards/build-dashboards/create-dashboard/index.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/sources/dashboards/_index.md b/docs/sources/dashboards/_index.md index 37b0e0a1f83..c24b99d34cc 100644 --- a/docs/sources/dashboards/_index.md +++ b/docs/sources/dashboards/_index.md @@ -57,10 +57,14 @@ refs: ## Overview +{{< shared id="dashboard-overview" >}} + A Grafana dashboard is a set of one or more [panels](ref:panels), organized and arranged into one or more rows, that provide an at-a-glance view of related information. These panels are created using components that query and transform raw data from a data source into charts, graphs, and other visualizations. A data source can be an SQL database, Grafana Loki, Grafana Mimir, or a JSON-based API. It can even be a basic CSV file. Data source plugins take a query you want answered, retrieve the data from the data source, and reconcile the differences between the data model of the data source and the data model of Grafana dashboards. +{{< /shared >}} + Queries allow you to reduce the entirety of your data to a specific dataset, providing a more manageable visualization. Since data sources have their own distinct query languages, Grafana dashboards provide you with a query editor to accommodate these differences. A panel is the container that displays the visualization and provides you with various controls to manipulate it. Panel options let you customize many aspects of a visualization and the options differ based on which visualization you select. When the data format in a visualization doesn't meet your requirements, you can apply a transformation that manipulates the data returned by a query. diff --git a/docs/sources/dashboards/build-dashboards/create-dashboard/index.md b/docs/sources/dashboards/build-dashboards/create-dashboard/index.md index 02cd0ab1c1c..033972b0b12 100644 --- a/docs/sources/dashboards/build-dashboards/create-dashboard/index.md +++ b/docs/sources/dashboards/build-dashboards/create-dashboard/index.md @@ -90,12 +90,16 @@ Dashboards and panels allow you to show your data in visual form. Each panel nee **To create a dashboard**: +{{< shared id="create-dashboard" >}} + 1. Click **Dashboards** in the main menu. 1. Click **New** and select **New Dashboard**. 1. On the empty dashboard, click **+ Add visualization**. ![Empty dashboard state](/media/docs/grafana/dashboards/empty-dashboard-10.2.png) +{{< /shared >}} + 1. In the dialog box that opens, do one of the following: - Select one of your existing data sources.