diff --git a/_dashboards/discover/index-discover.md b/_dashboards/discover/index-discover.md
new file mode 100644
index 0000000000..ebf46b8c23
--- /dev/null
+++ b/_dashboards/discover/index-discover.md
@@ -0,0 +1,104 @@
+---
+layout: default
+title: Exploring data with Discover
+nav_order: 20
+has_children: true
+---
+
+# Exploring data with Discover
+
+**Discover** in OpenSearch Dashboards helps you extract insights and get value out of data assets across your organization. Discover enables you to:
+
+1. **Explore data**. You can explore, customize, and filter data as well as search data using [Dashboards Query Language (DQL)]({{site.url}}{{site.baseurl}}/dashboards/dql/).
+2. **Analyze data**. You can analyze data, view individual documents, and create tables summarizing data contents.
+3. **Visualize data**. You can display findings from your saved searches in a single dashboard that combines different data visualization types.
+
+## Try it: Exploring sample data with Discover
+
+This tutorial shows you how to use Discover to analyze and understand a sample dataset. At the end of this tutorial, you should be ready to use Discover with your own data.
+
+Before starting this tutorial, make sure you've added the **Sample flight data**. See [Quickstart guide for OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/dashboards/quickstart/) for information about how to get started.
+{: .warning}
+
+### Setting up data
+
+Watch the following short video or start with the tutorial steps to learn how to set up a sample dataset in Discover.
+
+
+
+1. Verify access to OpenSearch Dashboards by connecting to [http://localhost:5601](http://localhost:5601) from a browser. The default username and password are `admin`.
+1. On the **Home** page, choose **Discover** in the navigation pane.
+1. On the index pattern toolbar, select the **opensearch_dashboards_sample_data_flights** dataset.
+1. On the time filter toolbar, choose the calendar icon and then change the time range to **Last 7 days**.
+
+### Exploring the data fields
+
+In the **Discover** panel, you'll see a table that shows all the documents that match your search. The table includes a list of data fields that are available in the document table, as shown in the following image.
+
+
+
+Follow these steps to explore the data fields:
+
+1. View the list of **Available fields**.
+1. Choose **Cancelled** to view the values (`true` and `false`).
+1. Choose the plus (+) sign to add the field to the document table. The field will be automatically added to **Selected fields** and the document table.
+1. Select **FlightDelay** from the **Available fields** list, and then choose the plus (+) sign to add the field to the document table.
+1. Optional: Rearrange the table columns by selecting the table header and then choosing **Move left** or **Move right**.
+
+## Searching data
+
+You can use the search toolbar or enter a DQL query in the **DevTools** console to search data in Dashboards, as shown in the following image. The search toolbar is best for basic queries, such as searching by a field name. DQL is best for complex queries, such as searching data using a term, string, Boolean, date, range, or nested query.
+
+
+
+Follow these steps to search data:
+
+1. In the search toolbar, enter the Boolean query. For example, enter `FlightDelay:true AND FlightDelayMin >= 60` to search the data for flights delayed by 60 minutes or more.
+1. Choose **Update**.
+1. Optional: Choose the arrow (`>`) in a table row to expand the row and view the document table details.
+
+## Filtering data
+
+Filters allow you to refine sets of documents to subsets of those documents. For example, you can filter data to include or exclude certain fields, as shown in the following image.
+
+
+
+Follow these steps to filter data:
+
+1. In the filter bar, choose **Add filter**.
+1. Select options from the **Field**, **Operator**, and **Value** dropdown lists. For example, `Cancelled`, `is`, and `true`.
+1. Choose **Save**.
+1. To remove the filter, choose the close icon (x) next to the filter name.
+1. Optional: Add more filters to further explore the data.
+
+## Analyzing data in the document table
+
+You can view the document table fields to better understand the data and gather insights for more informed decision-making:
+
+1. Choose the arrow icon (>) to expand a table row.
+1. View the fields and details.
+1. Switch between the **Table** and **JSON** tabs to view the different formats, as shown in the following image.
+
+
+
+## Saving the search
+
+Saving a search saves the query text, filters, and current data view. To save your search to use it later, generate a report, or build visualizations and dashboards:
+
+1. Choose the save icon in the toolbar.
+1. Give the search a title, and then choose **Save**.
+1. Choose the save icon to access the saved search, as shown in the following image.
+
+
+
+## Visualizing the search
+
+You can quickly visualize an aggregated field from **Discover**:
+
+1. From the **Available fields** list, select `FlightDelayType` and then choose **Visualize**, as shown in the following image.
+
+
+
+Dashboards creates a visualization for this field, which in this case is a basic bar chart, as shown in the following image.
+
+
diff --git a/_dashboards/discover/index.md b/_dashboards/discover/index.md
deleted file mode 100644
index e8ffcef744..0000000000
--- a/_dashboards/discover/index.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-layout: default
-title: Discover
-nav_order: 10
-has_children: true
----
-
-# Discover
-
-**Discover** in OpenSearch Dashboards helps you extract insights and get value out of data assets across your organization. You can quickly ingest and query your data, display that data in visualizations and interactive dashboards, and deliver insights to your organization.
-
-
-
-## What's next?
-
-- [Running queries in the console]({{site.url}}{{site.baseurl}}/dashboards/run-queries/)
-- [Creating a dashboard with multiple data sources]({{site.url}}{{site.baseurl}}/)
diff --git a/_dashboards/discover/multi-data-sources.md b/_dashboards/discover/multi-data-sources.md
index 629d930516..0b19007d01 100644
--- a/_dashboards/discover/multi-data-sources.md
+++ b/_dashboards/discover/multi-data-sources.md
@@ -1,11 +1,11 @@
---
layout: default
-title: Multiple data sources
-parent: Discover
+title: Adding multiple data sources
+parent: Exploring data with Discover
nav_order: 5
---
-# Multiple data sources
+# Adding multiple data sources
The multiple data sources feature is an experimental feature released in OpenSearch 2.4. It can't be used in a production environment. For updates on the feature’s progress or to leave feedback on improving the feature, see the [OpenSearch Forum discussion](https://forum.opensearch.org/t/feedback-experimental-feature-connect-to-external-data-sources/11144).
{: .warning }
@@ -14,14 +14,14 @@ You can add multiple data sources to a single dashboard. OpenSearch Dashboards a
In this tutorial we provide the steps for enabling the `data_source` setting in Dashboards; adding credentials, data source connections, and index patterns; and combining visualizations in a single dashboard.
-## Try out the multiple data sources feature in your local environment
+## Try it: Exploring the multiple data sources feature in your local environment
This tutorial uses a preconfigured data source and index pattern, and you aren’t required to configure settings. However, you’ll need to enable the `data_source` setting in the configuration file before before getting started with exploring this feature.
{: .note }
The multiple data sources feature is experimental and can't be deployed into production. You can try it out with a sample data source and a sample index pattern. Before getting started, you must first edit the YAML configuration. The following section provides the steps for enabling the feature.
-## Edit the YAML configuration to enable the multiple data sources feature
+## Modifying the multiple data sources settings
Dashboards is configured in the cluster settings, and the multiple data sources feature is disabled by default. To enable it, you need to edit the configuration in `opensearch_dashboards.yml` and then restart the cluster.
@@ -33,7 +33,7 @@ To enable the feature:
4. Restart the Dashboards container.
5. Verify the feature configuration settings were created and configured properly by connecting to Dashboards through [http://localhost:5601](http://localhost:5601/) and viewing the **Stack Management** console. **Data Sources `Experimental`** will appear in the sidebar. Alternatively, you can open on [http://localhost:5601/app/management/opensearch-dashboards/dataSources](http://localhost:5601/app/management/opensearch-dashboards/dataSource).
-## Create a data source connection
+## Creating a data source connection
A data source connection specifies the parameters needed to connect to a data source. These parameters form a connection string for the data source. In Dashboards, you can add new data source connections or edit existing connections.
@@ -41,90 +41,103 @@ To create a new data source connection:
1. Open Dashboards. If you’re not running the security plugin, go to [`http://localhost:5601`](http://localhost:5601/). If you’re running the security plugin, go to [`https://localhost:5601`](https://localhost:5601/) and log in with the username `admin` and password `admin`.
-2. In the Dashboards console, select **Stack Management > Data Sources `Experimental` > Data Sources > Create data source connection**.
-
+1. In the Dashboards console, choose **Stack Management** > **Data Sources `Experimental`** > **Data Sources** > **Create data source connection**, as shown in the following image.
-3. Add information to each field to configure **Connection Details**, **Endpoint**, and **Authentication** to connect to a data source. For this tutorial, the **Endpoint URL** is `http://localhost:5601/app/management/opensearch-dashboards/dataSources`.
-
+
-4. Select **Create data source connection** to save your settings.
+1. Add information to each field to configure **Connection Details**, **Endpoint**, and **Authentication** to connect to a data source, as shown in the following image. For this tutorial, the **Endpoint URL** is `http://localhost:5601/app/management/opensearch-dashboards/dataSources`.
-5. Return to the **Data Sources** main page to confirm that the newly created data source is listed under **Data Sources**.
-
+
-6. (Optional): Select the data source to verify that the settings are configured properly.
-
+1. Choose **Create data source connection** to save your settings.
+1. Return to the **Data Sources** main page to confirm that the newly created data source is listed under **Data Sources**, as shown in the following image.
-## Create an index pattern
+
+
+1. Optional: Select the data source to verify that the settings are configured properly, as shown in the following image.
+
+
+
+## Creating an index pattern
Index patterns allow you to access the OpenSearch data that you want to explore. An index pattern selects the data to use and allows you to define the field properties. Learn how to load your own data and create an index pattern following these steps. This tutorial uses the preconfigured index pattern `opensearch_dashboards_sample_data_ecommerce Default`.
-1. In the Dashboards console, select **Index Patterns > Create index pattern**.
-
+1. In the Dashboards console, choose **Index Patterns** > **Create index pattern**, as shown in the following image.
+
+
+
+1. Choose **Use external data source connection**.
+1. Start typing in the **Search data sources** field to search for the data source you created earlier and then select the data source and **Next step**, as shown in the following image.
+
+ 
-2. Select **Use external data source connection**.
-3. Start typing in the Search data sources field to search for the data source you created earlier and then select the data source and **Next step**.
-
+1. Add an **Index pattern name** to define the index pattern and then choose **Next step**, as shown in the following image.
-4. Add an **Index pattern name** to define the index pattern and then select **Next step**.
-
+
-5. Select an option for the **Time field** and then choose **Create index pattern**.
-
+1. Select an option for the **Time field** and then choose **Create index pattern**, as shown in the following image.
-## Search data
+
-Before you start searching for data, set up the time filter. The sample index pattern used for this tutorial contains time-based data. You can set a time filter that displays only the data within a specified time range, and you can select the time filter to change the time range or select a specific time range in the histogram.
+## Searching data
-### Use the time filter
+Before you start searching for data, set up the time filter. The sample index pattern used for this tutorial contains time-based data. You can set a time filter that displays only the data within a specified time range, and you can choose the time filter to change the time range or select a specific time range in the histogram.
-1. In the Dashboards console, select **Discover** and confirm the index pattern being used is `opensearch_dashboards_sample_data_ecommerce`.
-2. Select the calendar icon to change the time field. The default is **Last 15 minutes**.
-3. Change the time field to **Last 7 days** and select **Refresh**.
-
+### Adjusting the time filter
-4. To set the start and end times, select the bar next to the time filter. In the popup, select **Absolute**, **Relative**, or **Now** and then specify the required options.
-
+To adjust the time filter:
-### Select a time range from the histogram
+1. In the Dashboards console, choose **Discover** and confirm that the index pattern being used is `opensearch_dashboards_sample_data_ecommerce`.
+2. Choose the calendar icon to change the time field. The default is **Last 15 minutes**.
+3. Change the time field to **Last 7 days** and choose **Refresh**, as shown in the following image.
+
+
+
+4. To set the start and end times, choose the bar next to the time filter. In the popup, select **Absolute**, **Relative**, or **Now** and then specify the required options, as shown in the following image.
+
+
+
+### Selecting a time range from the histogram
To select a time range for the histogram, you can do one of the following:
* Select the bar that represents the time range you want to zoom in on.
-* Select the bar and drag to view a specific time range. You must start the selection with the cursor over the background of the chart—the cursor changes to a plus sign when you hover over a valid start point.
+* Select the bar and drag to view a specific time range. You must start the selection with the cursor over the background of the chart (the cursor changes to a plus sign when you hover over a valid start point).
* Select the dropdown and then select an interval.
+The following image shows a date histogram with an interval dropdown list.
+
-## Create visualizations
+## Creating data visualizations for a dashboard
-Follow these steps to learn how to connect your visualizations in a single dashboard:
+Follow these steps to learn how to create data visualizations for a dashboard:
-1. In the Dashboards console, select **Visualize** > **Create visualization**.
-2. Select the visualization type. For this tutorial, select **Line**.
-3. Choose a source. For this tutorial, select the index pattern `opensearch_dashboards_sample_data_ecommerce`.
-4. Under **Buckets**, select **Add > X-axis**.
-5. In the **Aggregation** field, select **Date Histogram** and then **Update**.
-6. Select **Save** and add the file name. This tutorial uses preconfigured visualizations, so you won’t be able to save your visualization.
+1. In the Dashboards console, choose **Visualize** > **Create visualization**.
+2. Select the visualization type. For this tutorial, choose **Line**.
+3. Select a source. For this tutorial, choose the index pattern `opensearch_dashboards_sample_data_ecommerce`.
+4. Under **Buckets**, choose **Add** > **X-axis**.
+5. In the **Aggregation** field, choose **Date Histogram** and then choose **Update**.
+6. Optional: Choose **Save** and add the file name. This tutorial uses preconfigured data visualizations, so you can't save the file for this tutorial.
-## Connect visualizations in a single dashboard
+## Connecting visualizations in a single dashboard
Follow these steps to connect your visualizations in a single dashboard:
-1. In the Dashboards console, select **Dashboard > Create dashboard**.
-2. Select **Add an existing** and then select the data you want to add.
-3. Select **Save** and add the dashboard name in the **Title field**. This tutorial uses preconfigured dashboards, so you won’t be able to save your dashboard.
+1. In the Dashboards console, choose **Dashboard** > **Create dashboard**.
+2. Choose **Add an existing** and then select the data you want to add.
+3. Choose **Save** and add the dashboard name in the **Title field**. This tutorial uses preconfigured dashboards, so you won’t be able to save your dashboard.
4. Click on the white space left of **Add panels** to view the visualizations in a single dashboard.
-Your dashboard might look like this:
+Your dashboard might look like the one in the following image.
-
+
-You have now explored the data sources experimental feature. We look forward to your feedback on how we can improve this feature ahead of its release for production use.
+You have now explored the data sources experimental feature. To provide feedback on how this feature can be improved ahead of its release for production use, comment in the [OpenSearch forum](https://forum.opensearch.org/).
-## Limitations
+## Understanding feature limitations
-The following limitations apply to the OpenSearch 2.4 release of this experimental feature:
+The following limitations apply to this experimental feature:
* The multiple data sources feature is supported for index-pattern-based visualizations only.
* The visualization types Time Series Visual Builder (TSVB), Vega and Vega-Lite, and timeline are not supported.
@@ -132,5 +145,4 @@ The following limitations apply to the OpenSearch 2.4 release of this experiment
## Related topics
-* [OpenSearch 2.4.0 is ready for download](https://opensearch.org/blog/)
-* [OpenSearch Forum](https://forum.opensearch.org/)
\ No newline at end of file
+* [OpenSearch Forum](https://forum.opensearch.org/)
diff --git a/images/discover-analyze.png b/images/discover-analyze.png
new file mode 100644
index 0000000000..d2240b1f1c
Binary files /dev/null and b/images/discover-analyze.png differ
diff --git a/images/discover-data-fields.png b/images/discover-data-fields.png
new file mode 100644
index 0000000000..c7880c0e74
Binary files /dev/null and b/images/discover-data-fields.png differ
diff --git a/images/discover-filter.png b/images/discover-filter.png
new file mode 100644
index 0000000000..59fda9de27
Binary files /dev/null and b/images/discover-filter.png differ
diff --git a/images/discover-index.png b/images/discover-index.png
deleted file mode 100644
index 48f4690874..0000000000
Binary files a/images/discover-index.png and /dev/null differ
diff --git a/images/discover-save.png b/images/discover-save.png
new file mode 100644
index 0000000000..ab8eb4a9c0
Binary files /dev/null and b/images/discover-save.png differ
diff --git a/images/discover-search.png b/images/discover-search.png
new file mode 100644
index 0000000000..41f47fcb79
Binary files /dev/null and b/images/discover-search.png differ
diff --git a/images/discover-setting-up-data.gif b/images/discover-setting-up-data.gif
new file mode 100644
index 0000000000..17eac1b8b7
Binary files /dev/null and b/images/discover-setting-up-data.gif differ
diff --git a/images/discover-visualize-2.png b/images/discover-visualize-2.png
new file mode 100644
index 0000000000..c670533c0c
Binary files /dev/null and b/images/discover-visualize-2.png differ
diff --git a/images/discover-visualize.png b/images/discover-visualize.png
new file mode 100644
index 0000000000..b3aa643223
Binary files /dev/null and b/images/discover-visualize.png differ