[v10.4.x] Docs: add legends shared content (#88195)

* Docs: add legends shared content (#86814) * Updated shared file name and added missing options * Added legend options 1 shared file to relevant visualizations * Updated shared file name and corrected options * Added legend options 2 shared file to relevant visualizations * Updated legend content for heatmap and pie chart * Added where shared legend files are used in each file * Moved intro text out of viz pages into legend options shared files * Added reasoning to front matter of shared files * Added reasoning to front matter of shared files * Fixed version interpolation and added cloud links * Updated links in shared files (cherry picked from commit dad3069594) * Ran prettier
2024-05-23 08:33:06 -04:00
parent 9d34224c13
commit edecfc5093
12 changed files with 93 additions and 51 deletions
@@ -1,22 +0,0 @@
---
-title: Legend mode and legend placement
---
-
-### Legend mode
-
-Use these settings to define how the legend appears in your visualization. For more information about the legend, refer to [Configure a legend](../configure-legend/).
-
- **List -** Displays the legend as a list. This is a default display mode of the legend.
- **Table -** Displays the legend as a table.
- **Hidden -** Hides the legend.
-
-### Legend placement
-
-Choose where to display the legend.
-
- **Bottom -** Below the graph.
- **Right -** To the right of the graph.
-
-### Legend values
-
-Choose which of the [standard calculations]({{< relref "../../panels-visualizations/query-transform-data/calculation-types/" >}}) to show in the legend. You can have more than one.
@@ -0,0 +1,35 @@
+---
+title: Legend options
+comments: |
+  There are two legend shared files to cover the most common combinations of options. 
+  Using two shared files ensures that content remains consistent across visualizations that share the same options and users don't have to figure out which options apply to a specific visualization when reading that content. 
+  This file is used in the following visualizations: bar chart, candlestick, histogram, time series, trend, xy chart
+---
+
+Legend options control the series names and statistics that appear under or to the right of the graph. For more information about the legend, refer to [Configure a legend](../configure-legend/).
+
+### Visibility
+
+Toggle the switch to turn the legend on or off.
+
+### Mode
+
+Use these settings to define how the legend appears in your visualization.
+
+- **List -** Displays the legend as a list. This is a default display mode of the legend.
+- **Table -** Displays the legend as a table.
+
+### Placement
+
+Choose where to display the legend.
+
+- **Bottom -** Below the graph.
+- **Right -** To the right of the graph.
+
+#### Width
+
+Control how wide the legend is when placed on the right side of the visualization. This option is only displayed if you set the legend placement to **Right**.
+
+### Values
+
+Choose which of the [standard calculations](../../query-transform-data/calculation-types/) to show in the legend. You can have more than one.
@@ -0,0 +1,33 @@
+---
+title: Legend mode and legend placement
+comments: |
+  There are two legend shared files to cover the most common combinations of options. 
+  Using two shared files ensures that content remains consistent across visualizations that share the same options and users don't have to figure out which options apply to a specific visualization when reading that content. 
+  This file is used in the following visualizations: state timeline, status history
+---
+
+When the legend option is enabled it can show either the value mappings or the threshold brackets. To show the value mappings in the legend, it's important that the **Color scheme** as referenced in [Color scheme](../../configure-standard-options#color-scheme) is set to **Single color** or **Classic palette**. To see the threshold brackets in the legend set the **Color scheme** to **From thresholds**.
+
+For more information about the legend, refer to [Configure a legend](../configure-legend/).
+
+### Visibility
+
+Toggle the switch to turn the legend on or off.
+
+### Mode
+
+Use these settings to define how the legend appears in your visualization.
+
+- **List -** Displays the legend as a list. This is a default display mode of the legend.
+- **Table -** Displays the legend as a table.
+
+### Placement
+
+Choose where to display the legend.
+
+- **Bottom -** Below the graph.
+- **Right -** To the right of the graph.
+
+#### Width
+
+Control how wide the legend is when placed on the right side of the visualization. This option is only displayed if you set the legend placement to **Right**.