Dashboards first 20 lines optimization

.gitignore

@@ -9,7 +9,7 @@
 # Add LLM/AI related files
 AGENTS.md
 .github/copilot-instructions.md
-.github/instructions
+.github/instructions/
 CLAUDE.md
 GEMINI.md
 .cursor

explore-analyze/dashboards.md

@@ -1,5 +1,6 @@
 ---
 navigation_title: Dashboards
+description: Visualize and share insights from your Elasticsearch data using interactive panels, charts, maps, and custom filters.
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/dashboard.html
 applies_to:
@@ -9,14 +10,42 @@
   - id: kibana
 ---
 
-# {{kib}} dashboards [dashboard]
+# Dashboards [dashboard]
 
-Dashboards are the best way to visualize and share insights from your {{es}} data.
+**Dashboards** provide the primary way to visualize and share insights from your {{es}} data. They allow you to build interactive displays that combine multiple visualizations, metrics, and controls into a single view that helps you and your team monitor trends, investigate issues, and make data-driven decisions.
 
-A **dashboard** is made of one or more **panels** that you can organize as you like. Each panel can display various types of content: **visualizations** such as charts, tables, metrics, and maps, **static annotations** like text or images, or even **specialized views** for Machine Learning or Observability data.
+A dashboard is composed of one or more **panels** that you arrange to tell your data story. Each panel can display visualizations such as charts, tables, metrics, and maps, static annotations like text or images, or specialized views for {{ml}} or {{observability}} data.
 
 ![Example dashboard](/explore-analyze/images/kibana-dashboard-overview.png "")
 
-At any time, you can [share a dashboard](dashboards/sharing.md) you’ve created with your team, in {{kib}} or outside.
+## Get started with dashboards [get-started-with-dashboards]
 
-Some dashboards are created and managed by the system, and are identified as `managed` in your list of dashboards. This generally happens when you set up an integration to add data. You can’t edit managed dashboards directly, but you can [duplicate](dashboards/duplicate-dashboards.md) them and edit these duplicates.
+New to dashboards? Start with these hands-on tutorials that walk you through creating your first dashboards using sample data:
+
+- [Create a simple dashboard to monitor website logs](dashboards/create-dashboard-of-panels-with-web-server-data.md): Build a dashboard with charts, metrics, and filters to analyze web traffic patterns.
+- [Create a dashboard with time series charts](dashboards/create-dashboard-of-panels-with-ecommerce-data.md): Learn to visualize sales trends and patterns over time using eCommerce data.
+
+
+## Work with dashboards [work-with-dashboards]
+
+Once you understand the basics, explore these common tasks:
+
+**Explore and interact**
+- [Explore dashboards](dashboards/using.md): Filter data, adjust time ranges, and interact with panels to uncover insights.
+
+**Build and customize dashboards**
+- [Build dashboards](dashboards/building.md): Learn the fundamentals of creating and configuring dashboards.
+- [Create a dashboard](dashboards/create-dashboard.md): Start with an empty dashboard and add your content.
+- [Add filter controls](dashboards/add-controls.md): Enable interactive filtering with options lists, range sliders, and time sliders.
+- [Add drilldowns](dashboards/drilldowns.md): Create interactive navigation between dashboards or to external URLs.
+- [Organize dashboard panels](dashboards/arrange-panels.md): Arrange panels using collapsible sections, resizing, and positioning.
+
+**Manage and share**
+- [Manage dashboards](dashboards/managing.md): Browse, search, organize, and track usage of your dashboards.
+- [Share dashboards](dashboards/sharing.md): Share with your team using links, embeds, or file exports.
+- [Duplicate a dashboard](dashboards/duplicate-dashboards.md): Create customizable copies of existing dashboards.
+- [Import a dashboard](dashboards/import-dashboards.md): Bring dashboards from other environments.
+
+## About managed dashboards [managed-dashboards]
+
+Some dashboards are created and managed by the system, and are identified as `managed` in your list of dashboards. This generally happens when you set up an integration to add data. You can't edit managed dashboards directly, but you can [duplicate](dashboards/duplicate-dashboards.md) them and edit the duplicates.

explore-analyze/dashboards/add-controls.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/add-controls.html
+description: Add interactive filter controls to your Kibana dashboards to help users explore data with options lists, range sliders, and time sliders.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,7 +11,17 @@ products:
 
 # Add filter controls [add-controls]
 
-**Controls** are interactive panels that you add to your dashboards to help viewers filter and display only the data they want to explore quicker. Controls apply to all relevant panels in a dashboard.
+**Controls** are interactive options that you add to your dashboards to help future viewers filter and display only the data they want to explore more efficiently. Controls apply filters across all relevant panels in a dashboard to focus on specific data segments without writing filtering queries.
+
+## Requirements [add-controls-requirements]
+
+To add controls to a dashboard, you need:
+
+* **All** privilege for the **Dashboard** feature in {{product.kibana}}
+* An existing dashboard open in **Edit** mode
+* A [data view](../find-and-organize/data-views.md) configured with fields available for filtering
+
+## Control types [control-types]
 
 There are three types of controls:
 

explore-analyze/dashboards/arrange-panels.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/arrange-panels.html
+description: Organize and arrange dashboard panels using collapsible sections, resizing, positioning, and duplication to improve readability and performance.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,7 +11,11 @@ products:
 
 # Organize dashboard panels [arrange-panels]
 
-Customize your dashboard layout by arranging panels into logical groups and adjusting their size and position. When panels are well organized, it makes your dashboard easier to read, faster to load, and helps its viewers locate important information quicker.
+Customize your dashboard layout by arranging panels into logical groups and adjusting their size and position. When panels are well organized, your dashboard becomes easier to read, loads faster, and helps viewers locate important information more quickly.
+
+## Requirements [arrange-panels-requirements]
+
+To organize dashboard panels, you need the **All** privilege for the **Dashboard** feature in {{product.kibana}}.
 
 ## Arrange panels in collapsible sections [collapsible-sections]
 ```{applies_to}

explore-analyze/dashboards/building.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/create-dashboards.html
+description: Build powerful Kibana dashboards using visualizations, metrics, text, images, and interactive controls to monitor and analyze your data.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,20 +11,23 @@ products:
 
 # Building dashboards [create-dashboards]
 
-{{kib}} offers many ways to build powerful dashboards that will help you visualize and keep track of the most important information contained in your {{es}} data.
+{{product.kibana}} offers many ways to build powerful dashboards that help you visualize and keep track of the most important information in your {{product.elasticsearch}} data. Combine multiple visualizations, metrics, and interactive elements into a cohesive view that tells your data story and enables rapid decision-making.
 
-* Create and assemble visualizations such as charts or maps, and enrich them with helpful legends containing key data.
-* Extract and show key indicators and metrics to keep them visible and highlighted at all times.
-* Add text, images, and links to help viewers make the most of your dashboard.
-* Include additional controls to facilitate filtering and browsing the data.
+You can:
 
-$$$dashboard-minimum-requirements$$$
-To create or edit dashboards, you first need to:
+* Create and assemble visualizations such as charts or maps, and enrich them with helpful legends containing key data
+* Extract and show key indicators and metrics to always keep them visible and highlighted
+* Add text, images, and links to help viewers make the most of your dashboard
+* Include additional controls to facilitate filtering and browsing the data
 
-* have [data indexed into {{es}}](/manage-data/ingest.md) and a [data view](../find-and-organize/data-views.md). A data view is a subset of your {{es}} data, and allows you to load the right data when building a visualization or exploring it.
+## Requirements [dashboard-minimum-requirements]
+
+To create or edit dashboards, you need:
+
+* [Data indexed into {{product.elasticsearch}}](/manage-data/ingest.md) and a [data view](../find-and-organize/data-views.md). A data view is a subset of your {{product.elasticsearch}} data, and allows you to load the right data when building a visualization or exploring it.
 
   ::::{tip}
-  If you don’t have data at hand and still want to explore dashboards, you can import one of the [sample data sets](../../manage-data/ingest/sample-data.md) available.
+  If you don't have data at hand and still want to explore dashboards, you can import one of the [sample data sets](../../manage-data/ingest/sample-data.md) available.
   ::::
 
-* have sufficient permissions on the **Dashboard** feature. If that’s not the case, you might get a read-only indicator. A {{kib}} administrator can [grant you the required privileges](../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-privileges.md).
+* Sufficient privileges for the **Dashboard** feature. Without them, you might get a read-only indicator. A {{product.kibana}} administrator can [grant you the required privileges](../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-privileges.md).

explore-analyze/dashboards/create-dashboard-of-panels-with-ecommerce-data.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/create-a-dashboard-of-panels-with-ecommerce-data.html
+description: Step-by-step tutorial for creating a Kibana dashboard with time series visualizations to analyze eCommerce sales trends and patterns.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,9 +11,9 @@
 
 # Create a dashboard with time series charts [create-a-dashboard-of-panels-with-ecommerce-data]
 
-In this tutorial, you’ll use the ecommerce sample data to analyze sales trends, but you can use any type of data to complete the tutorial.
+Learn how to create time series visualizations and build a dashboard that tracks trends over time. This tutorial uses eCommerce sample data to analyze sales patterns, but you can apply these techniques to any time-based data.
 
-When you’re done, you’ll have a complete overview of the sample web logs data.
+When you're done, you'll have a complete dashboard showing sales trends, revenue patterns, and customer behavior over time.
 
 :::{image} /explore-analyze/images/kibana-lens_timeSeriesDataTutorialDashboard_8.3.png
 :alt: Final dashboard with eCommerce sample data

explore-analyze/dashboards/create-dashboard-of-panels-with-web-server-data.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/create-a-dashboard-of-panels-with-web-server-data.html
+description: Step-by-step tutorial for creating a Kibana dashboard to monitor and analyze website log data using visualizations and panels.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,9 +11,9 @@
 
 # Create a simple dashboard to monitor website logs [create-a-dashboard-of-panels-with-web-server-data]
 
-Learn the most common ways to create a dashboard from your own data. The tutorial will use sample data from the perspective of an analyst looking at website logs, but this type of dashboard works on any type of data.
+Learn the most common ways to create a dashboard from your own data. This tutorial uses sample web logs data from the perspective of an analyst monitoring website traffic, but you can apply these techniques to any type of data.
 
-When you’re done, you’ll have a complete overview of the sample web logs data.
+When you're done, you'll have a complete overview of the sample web logs data that tracks key metrics like visitor counts, traffic sources, response codes, and geographic distribution.
 
 :::{image} /explore-analyze/images/kibana-lens_logsDashboard_8.4.0.png
 :alt: Logs dashboard

explore-analyze/dashboards/create-dashboard.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/create-dashboard.html
+description: Create a new Kibana dashboard from scratch by adding visualizations, controls, and organizing panels to display your data insights.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,17 +11,28 @@ products:
 
 # Create a dashboard [create-dashboard]
 
-1. Open the **Dashboards** page in {{kib}}.
+Create a new dashboard in {{product.kibana}} to start visualizing and monitoring your data. Once created, you can add visualizations, configure interactive controls, and organize panels to build a comprehensive view of your data that meets your specific monitoring and analysis needs.
+
+## Requirements [create-dashboard-requirements]
+
+Before creating a dashboard, ensure you have:
+
+* [Data indexed into {{product.elasticsearch}}](/manage-data/ingest.md) and at least one [data view](../find-and-organize/data-views.md) configured
+* **All** privilege for the **Dashboard** feature in {{product.kibana}}
+
+## Create a new dashboard [create-dashboard-steps]
+
+1. Open the **Dashboards** page in {{product.kibana}}.
 2. Select **Create dashboard** to start with an empty dashboard.
 
     When you create a dashboard, you are automatically in edit mode and can make changes to the dashboard.
 
 3. Populate your dashboard with the content that you need. You can:
 
-    * [**Add new visualizations**](../visualize.md#panels-editors). Create a chart using [Lens](../visualize/lens.md), the default visualization editor in {{kib}}, or other visualizations such as [Maps](../visualize/maps.md).
+    * [**Add new visualizations**](../visualize.md#panels-editors). Create a chart using [Lens](../visualize/lens.md), the default visualization editor in {{product.kibana}}, or other visualizations such as [Maps](../visualize/maps.md).
     * [**Add existing content from the library**](../visualize/visualize-library.md). Select existing visualizations or Discover sessions that have already been configured and saved to the **Visualize Library**.
     * [**Add annotations or navigation panels**](../visualize.md#panels-editors). Make your dashboard more informative and easier to read with sections, text, and images.
-    * [**Add controls**](add-controls.md). Define a set of interactive filters (options lists, range or time sliders) that you and future users of this dashboard can use to explore its data.  
+    * [**Add controls**](add-controls.md). Define a set of interactive filters (options lists, range or time sliders) that you and future users of this dashboard can use to explore its data.
 
 4. Organize your dashboard by [organizing the various panels](arrange-panels.md).
 5. Define the main settings of your dashboard from the **Settings** menu located in the toolbar.

explore-analyze/dashboards/drilldowns.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/drilldowns.html
+description: Add drilldowns to Kibana dashboard panels to navigate to other dashboards, external URLs, or Discover while preserving context and filters.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,7 +11,18 @@ products:
 
 # Add drilldowns [drilldowns]
 
-Panels have built-in interactive capabilities that apply filters to the dashboard data. For example, when you drag a time range or click a pie slice, a filter for the time range or pie slice is applied. Drilldowns let you customize the interactive behavior while keeping the context of the interaction.
+Panels have built-in interactive capabilities that apply filters to the dashboard data. For example, when you drag a time range slider or click a pie chart slice, this applies a filter for the time range or pie slice. **Drilldowns** let you customize and extend this interactive behavior by defining what happens when you click on data points, while keeping interaction context such as filters, time ranges, and selected values.
+
+## Requirements [drilldowns-requirements]
+
+To add drilldowns to dashboard panels, you need:
+
+* **All** privilege for the **Dashboard** feature in {{product.kibana}}
+* An existing dashboard with at least one panel that supports drilldowns
+* For dashboard drilldowns: A target dashboard to navigate to
+* For URL drilldowns: A URL template that can include dynamic variables from the clicked data
+
+## Drilldown types [drilldown-types]
 
 There are three types of drilldowns you can add to dashboards:
 

explore-analyze/dashboards/duplicate-dashboards.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/duplicate-dashboards.html
+description: Duplicate an existing Kibana dashboard to create a copy that you can customize independently without affecting the original.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,6 +11,16 @@ products:
 
 # Duplicate a dashboard [duplicate-dashboards]
 
+Create a copy of an existing dashboard in {{product.kibana}} to customize it independently without affecting the original. This is particularly useful when you want to create variations of a dashboard for different teams or use cases, or when you need to edit a managed dashboard that comes from an integration.
+
+## Requirements [duplicate-dashboard-requirements]
+
+To duplicate a dashboard, you need:
+
+* **All** privilege for the **Dashboard** feature in {{product.kibana}}
+
+## Duplicate a dashboard [duplicate-dashboard-steps]
+
 1. Open the dashboard you want to duplicate.
 2. Exit the edit mode, and click **Duplicate** in the toolbar.
 3. In the **Duplicate dashboard** window, enter a title and optional description and tags.

explore-analyze/dashboards/import-dashboards.md

@@ -1,6 +1,7 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/kibana/current/_import_dashboards.html
+description: Import dashboards and their related objects into Kibana from NDJSON files using the Saved Objects interface.
 applies_to:
   stack: ga
   serverless: ga
@@ -10,9 +11,21 @@
 
 # Import a dashboard [_import_dashboards]
 
+Import dashboards into {{product.kibana}} from NDJSON files exported from other {{product.kibana}} instances or spaces. When you import a dashboard, you also import its related objects such as data views and visualizations, making it easy to migrate dashboards between environments or share them with other teams.
+
+## Requirements [import-dashboard-requirements]
+
+To import dashboards, you need:
+
+* **All** privilege for the **Dashboard** and **Saved Objects Management** features in {{product.kibana}}
+* An NDJSON file containing the dashboard and its related objects
+* Access to **Stack Management** in {{product.kibana}}
+
+## Import a dashboard [import-dashboard-steps]
+
 You can import dashboards from the [Saved Objects](../find-and-organize/saved-objects.md) page under **Stack Management**.
 
-When importing dashboards, you also import their related objects, such as data views and visualizations. Import options allow you to define how the import should behave with these related objects.
+When importing dashboards, you also import their related objects, such as data views and visualizations. Import options allow you to define how the import should behave with these related objects:
 
 * **Check for existing objects**: When selected, objects are not imported when another object with the same ID already exists in this space or cluster. For example, if you import a dashboard that uses a data view which already exists, the data view is not imported and the dashboard uses the existing data view instead. You can also chose to select manually which of the imported or the existing objects are kept by selecting **Request action on conflict**.
 * **Create new objects with random IDs**: All related objects are imported and are assigned a new ID to avoid conflicts.