Skip to content

Commit bcbb7e3

Browse files
Consolidate duplicate "Access Lens" and "Save" steps into shared snippets across all 13 chart pages (#7020)
All 13 Lens chart pages repeated identical (or near-identical) "Access Lens" and "Save the chart" step content inline, diverging in minor wording over time. This follows the existing `lens-prerequisites.md` snippet pattern already in use on these pages. ## New snippets - `explore-analyze/_snippets/access-lens.md` — generic "Access Lens" step body (only variation was chart type name, replaced with "the visualization") - `explore-analyze/_snippets/save-visualization.md` — canonical "Save" step body with consistent wording ## All 13 chart pages updated Inline content replaced with `:::{include}` directives: ```md :::::{step} Access Lens :::{include} ../../_snippets/access-lens.md ::: ::::: :::::{step} Save the chart :::{include} ../../_snippets/save-visualization.md ::: ::::: ``` ## Wording standardized - `"offers you to add"` → `"lets you add"` (gauge, heat-map) - `"be able to add it to other dashboards later"` → `"reuse it later"` (bar, metric, tables) - `line-charts.md` truncated save instructions restored to full canonical text - Fixed double-period typo in `metric-charts.md` --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: Florent LB <florent.leborgne@elastic.co>
1 parent b6c3224 commit bcbb7e3

15 files changed

Lines changed: 57 additions & 65 deletions
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
**Lens** is {{kib}}'s main visualization editor. You can access it:
2+
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add the visualization, then add a new visualization.
3+
- From the **Visualize library** page by creating a new visualization.
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and be able to add it to other dashboards later.
2+
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and lets you add the visualization to a dashboard and to the Visualize library.

explore-analyze/visualize/charts/area-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,8 @@ To build an area chart:
3131
::::::{stepper}
3232

3333
:::::{step} Access Lens
34-
**Lens** is {{kib}}'s main visualization editor. You can access it:
35-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add an area chart, then add a new visualization.
36-
- From the **Visualize library** page by creating a new visualization.
34+
:::{include} ../../_snippets/access-lens.md
35+
:::
3736
:::::
3837

3938
:::::{step} Set the visualization to Area
@@ -74,8 +73,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
7473
:::::
7574

7675
:::::{step} Save the chart
77-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and reuse it later.
78-
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and lets you add the visualization to a dashboard and to the Visualize library.
76+
:::{include} ../../_snippets/save-visualization.md
77+
:::
7978
:::::
8079

8180
::::::

explore-analyze/visualize/charts/bar-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,8 @@ To build a bar chart:
3333
:::::{stepper}
3434

3535
::::{step} Access Lens
36-
**Lens** is {{kib}}'s main visualization editor. You can access it:
37-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add a bar chart, then add a new visualization.
38-
- From the **Visualize library** page by creating a new visualization.
36+
:::{include} ../../_snippets/access-lens.md
37+
:::
3938
::::
4039

4140
::::{step} Set the visualization to Bar
@@ -82,8 +81,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
8281
::::
8382

8483
::::{step} Save the chart
85-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and be able to add it to other dashboards later.
86-
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and lets you add the visualization to a dashboard and to the Visualize library.
84+
:::{include} ../../_snippets/save-visualization.md
85+
:::
8786
::::
8887

8988
:::::

explore-analyze/visualize/charts/gauge-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,8 @@ To build a gauge chart:
2626
::::::{stepper}
2727

2828
:::::{step} Access Lens
29-
**Lens** is {{kib}}'s main visualization editor. You can access it:
30-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add a gauge chart, then add a new visualization.
31-
- From the **Visualize library** page by creating a new visualization.
29+
:::{include} ../../_snippets/access-lens.md
30+
:::
3231
:::::
3332

3433
:::::{step} Set the visualization to Gauge
@@ -72,8 +71,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
7271
:::::
7372

7473
:::::{step} Save the chart
75-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and reuse it later.
76-
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and offers you to add the visualization to a dashboard and to the Visualize library.
74+
:::{include} ../../_snippets/save-visualization.md
75+
:::
7776
:::::
7877

7978
::::::

explore-analyze/visualize/charts/heat-map-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,8 @@ To build a heat map chart:
2626
::::::{stepper}
2727

2828
:::::{step} Access Lens
29-
**Lens** is {{kib}}'s main visualization editor. You can access it:
30-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add a heat map chart, then add a new visualization.
31-
- From the **Visualize library** page by creating a new visualization.
29+
:::{include} ../../_snippets/access-lens.md
30+
:::
3231
:::::
3332

3433
:::::{step} Set the visualization to Heat map
@@ -69,8 +68,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
6968
:::::
7069

7170
:::::{step} Save the chart
72-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and reuse it later.
73-
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and offers you to add the visualization to a dashboard and to the Visualize library.
71+
:::{include} ../../_snippets/save-visualization.md
72+
:::
7473
:::::
7574

7675
::::::

explore-analyze/visualize/charts/line-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,8 @@ To build a line chart:
3131
::::::{stepper}
3232

3333
:::::{step} Access Lens
34-
**Lens** is {{kib}}'s main visualization editor. You can access it:
35-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add a line chart, then add a new visualization.
36-
- From the **Visualize library** page by creating a new visualization.
34+
:::{include} ../../_snippets/access-lens.md
35+
:::
3736
:::::
3837

3938
:::::{step} Set the visualization to Line
@@ -70,8 +69,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
7069
:::::
7170

7271
:::::{step} Save the chart
73-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library.
74-
- If you accessed Lens from the Visualize library, select **Save**. The Save menu also lets you add the visualization to a dashboard and the Visualize library.
72+
:::{include} ../../_snippets/save-visualization.md
73+
:::
7574
:::::
7675

7776
::::::

explore-analyze/visualize/charts/metric-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,8 @@ To build a metric chart:
3535
:::::{stepper}
3636

3737
::::{step} Access Lens
38-
**Lens** is {{kib}}'s main visualization editor. You can access it:
39-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add a metric chart, then add a new visualization.
40-
- From the **Visualize library** page by creating a new visualization..
38+
:::{include} ../../_snippets/access-lens.md
39+
:::
4140
::::
4241

4342
::::{step} Set the visualization to Metric
@@ -77,8 +76,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
7776
::::
7877

7978
::::{step} Save the chart
80-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and be able to add it to other dashboards later.
81-
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and lets you add the visualization to a dashboard and to the Visualize library.
79+
:::{include} ../../_snippets/save-visualization.md
80+
:::
8281
::::
8382

8483
:::::

explore-analyze/visualize/charts/mosaic-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,8 @@ To build a mosaic chart:
2626
::::::{stepper}
2727

2828
:::::{step} Access Lens
29-
**Lens** is {{kib}}'s main visualization editor. You can access it:
30-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add a mosaic chart, then add a new visualization.
31-
- From the **Visualize library** page by creating a new visualization.
29+
:::{include} ../../_snippets/access-lens.md
30+
:::
3231
:::::
3332

3433
:::::{step} Set the visualization to Mosaic
@@ -67,8 +66,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
6766
:::::
6867

6968
:::::{step} Save the chart
70-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and reuse it later.
71-
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and lets you add the visualization to a dashboard and to the Visualize library.
69+
:::{include} ../../_snippets/save-visualization.md
70+
:::
7271
:::::
7372

7473
::::::

explore-analyze/visualize/charts/pie-charts.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,8 @@ To build a pie chart:
2424
::::::{stepper}
2525

2626
:::::{step} Access Lens
27-
**Lens** is {{kib}}'s main visualization editor. You can access it:
28-
- From a dashboard: On the **Dashboards** page, open or create the dashboard where you want to add a pie chart, then add a new visualization.
29-
- From the **Visualize library** page by creating a new visualization.
27+
:::{include} ../../_snippets/access-lens.md
28+
:::
3029
:::::
3130

3231
:::::{step} Set the visualization to Pie
@@ -71,8 +70,8 @@ For panel sizing and layout guidance, refer to [Organize dashboard panels](../..
7170
:::::
7271

7372
:::::{step} Save the chart
74-
- If you accessed Lens from a dashboard, select **Save and return** to save the visualization and add it to that dashboard, or select **Save to library** to add the visualization to the Visualize library and reuse it later.
75-
- If you accessed Lens from the Visualize library, select **Save**. A menu opens and lets you add the visualization to a dashboard and to the Visualize library.
73+
:::{include} ../../_snippets/save-visualization.md
74+
:::
7675
:::::
7776

7877
::::::

0 commit comments

Comments
 (0)