Update OSD Discover application documentation

_dashboards/dashboard/plugins-dashboards.md

@@ -17,26 +17,26 @@ As of OpenSearch 2.7, you can manage your observability plugins with **Observabi
 - **Enhanced security:** With a list of plugins readily available from a dashboard, you can easily see if any outdated or vulnerable plugins are present and then quickly remove or update them, minimizing or avoiding security risks.
 - **Improved website performance:** Viewing a list of plugins from a dashboard can help you identify any plugins that may be slowing down your website or causing performance issues.
 
-Get familiar with the basics of managing plugins from the Dashboard app in less than 20 seconds in the following video.
+Get familiar with the basics of managing plugins from the Dashboards app in less than 20 seconds in the following video.
 
-![Demo of using Dashboard to view a list of observability plugins](https://user-images.githubusercontent.com/105296784/234345611-50beb9a6-6118-449a-b015-b9f9e90b525e.gif)
+![Demo of using Dashboards to view a list of observability plugins](https://user-images.githubusercontent.com/105296784/234345611-50beb9a6-6118-449a-b015-b9f9e90b525e.gif)
 
 ## Viewing a list of installed plugins
 
-To view a list of installed plugins from the Dashboard app, follow these steps:
+To view a list of installed plugins from the Dashboards app, follow these steps:
 
-1. From the OpenSearch Dashboards main menu, select **Dashboard**.
+1. From the OpenSearch Dashboards main menu, select **Dashboards**.
 2. View the list of items and select your plugin. Plugins are categorized automatically as the Observability Dashboard data type, which you can filter in order to concentrate on just what you want to see.
 
 ## Adding and removing plugins
 
-To add a plugin from the Dashboard app, follow these steps:
+To add a plugin from the Dashboards app, follow these steps:
 
-1. From the OpenSearch Dashboards main menu, select **Dashboard**.
+1. From the OpenSearch Dashboards main menu, select **Dashboards**.
 2. In the **Dashboards** window, select **Create** > **Dashboard**.
-3. In the **Create operational panel** window, enter a name in the **Name** field and then select **Create**. The plugin is added to both the Observability app and the Dashboard app.
+3. In the **Create operational panel** window, enter a name in the **Name** field and then select **Create**. The plugin is added to both the Observability app and the Dashboards app.
 
-You can remove a plugin from the Dashboard app by selecting the edit icon under the **Actions** column and then selecting **Delete**.
+You can remove a plugin from the Dashboards app by selecting the edit icon under the **Actions** column and then selecting **Delete**.
 
 ## Staying updated about OpenSearch Dashboards plugins
 

_dashboards/discover/field-select.md

@@ -0,0 +1,117 @@
+---
+layout: default
+title: Field select tool
+parent: Exploring data with Discover
+grand_parent: Exploring data
+nav_order: 40
+---
+
+# Using the field select tool
+
+By default, the Discover application's **Results** table displays all fields for every document in the table. In the field select tool, you can select which data fields appear in the **Results** table.
+
+The field select tool is in the vertical panel to the immediate left of the [Discover]({{site.url}}{{site.baseurl}}/dashboards/discover/index-discover/) application pane. It is available only in the **Discover** application.
+
+
+## Navigating the field select tool
+
+<img src="{{site.url}}{{site.baseurl}}/images/dashboards/field-select-collapsed-callouts.png" alt="Field select tool"  width="44%">
+
+The following components make up the field select tool.
+
+- The **Index patterns** dropdown (A) presents all available index patterns. The selected index pattern determines what data are loaded and therefore which fields are available in the field select tool.
+- The **Search field names** (B) box narrows the fields available in the select tool by matching field names to your search string.
+- The **Filter by type** dropdown (C) narrows the fields available based on data properties such as data type and searchability.
+- The **Selected fields** list (D) is a collapsible list of all selected fields.
+- The **Popular fields** list (E) is a collapsible list of recently selected fields.
+- The **Available fields** list (F) is a collapsible list of all fields that have not been selected.
+
+The **Selected fields**, **Popular fields**, and **Available fields** lists are mutually exclusive. A field appears in only one of these collapsible lists.
+{: .important}
+
+
+## Selecting an index pattern
+
+Before exploring and visualizing data, you must select an index pattern.
+
+An index pattern is equivalent to a table view in a traditional relational database system. It defines the data set that you are interested in exploring and visualizing. For information about creating index patterns, see [Index patterns]({{site.url}}{{site.baseurl}}/dashboards/management/index-patterns/).
+
+To select an index pattern, follow these steps:
+
+1. In the field select tool, select an index pattern from the **Index patterns** dropdown.
+
+
+## Selecting fields to display
+
+To select a field for display in the **Results** table, follow these steps:
+
+1. Select {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/arrow-right-icon.png" class="inline-icon" alt="expand icon"/>{:/} (expand) **Available fields** to expand the **Available fields**. 
+
+   If the field has been used recently, it might be in the **Popular fields** list instead of **Available fields**.
+   {: .note}
+
+1. (Optional) [Use the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="funnel icon"/>{:/} **Filter by type**](#filtering-fields-by-type   ) popover to narrow the available fields by type.
+
+1. (Optional) Enter text in the **Search field names** box to narrow the list of available fields.
+
+1. Select a field in the **Available fields** or **Popular fields** list.
+
+1. Choose the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/green-plus-icon.png" class="inline-icon" alt="green plus icon"/>{:/} (add) icon of the selected field.
+
+   The field is added as a column in the **Results** table in the **Discover** application pane.
+
+## Removing fields
+
+To remove a field from display in the **Results** table, follow these steps:
+
+1. Select {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/arrow-right-icon.png" class="inline-icon" alt="expand icon"/>{:/} (expand) **Selected fields** to expand the **Selected fields**.
+
+1. Choose a field in the **Selected fields** list.
+
+1. Choose the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/red-cross-icon.png" class="inline-icon" alt="red cross icon"/>{:/} (remove) icon of the selected field.
+
+   The field is removed from the **Results** table in the **Discover** application pane.
+
+   If the removed field was the last selected field, the **Results** table defaults back to displaying all fields.
+   {: .note}
+
+
+## Filtering fields by type
+
+Often the list of available fields is long. To avoid scrolling through the list, filter fields in the field select tool by data type and by whether they are aggregatable or searchable.
+
+The number to the right of {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="funnel icon"/>{:/} **Filter by type** indicates the number of active type filters.
+{: .tip}
+
+### Filtering fields by data type
+
+To narrow the fields in the field select tool by data type, follow these steps:
+
+1. Select {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="funnel icon"/>{:/} **Filter by type**.
+
+1. In the **Filter by type** popover, select a data type from the **Type** dropdown.
+
+   The fields are restricted to the selected type.
+
+   Fields are restricted in all the lists: **Selected fields**, **Popular fields**, and **Available fields**.
+   {: .note}
+
+### Filtering fields by property
+
+To filter fields by property, follow these steps:
+
+1. Select {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="funnel icon"/>{:/} **Filter by type**.
+
+1. In the **Filter by type** popover, select an **Aggregatable** option. For example, selecting **yes** filters out all non-aggregatable fields.
+
+1. In the **Filter by type** popover, select a **Searchable** option. For example, selecting **yes** filters out all non-searchable fields.
+
+   Searchable fields are fields that are included in the inverted index and are available for search. For more information, see [Index]({{site.url}}{{site.baseurl}}/mappings/mapping-parameters/index-parameter).
+
+### Filtering missing fields
+
+To filter out fields with missing data, follow these steps:
+
+1. Select {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="funnel icon"/>{:/} **Filter by type**.
+
+1. In the **Filter by type** popover, activate the **Hide missing fields** toggle.

_dashboards/discover/filter-tool.md

@@ -0,0 +1,166 @@
+---
+layout: default
+title: Filter tool
+parent: Exploring data with Discover
+grand_parent: Exploring data
+nav_order: 30
+---
+
+# Using the filter tool
+
+The filter tool is at the top of the [Discover]({{site.url}}{{site.baseurl}}/dashboards/discover/index-discover/) and [Dashboard]({{site.url}}{{site.baseurl}}/dashboards/dashboard/index/) and [Visualize]({{site.url}}{{site.baseurl}}/dashboards/visualize/viz-index/) applications, directly below the **[Search]({{site.url}}{{site.baseurl}}/dashboards/discover/search-bar/)** bar. Use it to add and remove discrete filters to the data displayed in those applications.
+
+ You can create any number of filters. Filters are listed in the filter display between the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) icon and the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/add-filter-icon.png" class="inline-icon" alt="add filter icon"/>{:/} (circle-plus) **Add filter** control.
+
+
+## Navigating the filter tool
+
+<img src="{{site.url}}{{site.baseurl}}/images/dashboards/filter-tool-callouts.png" width="75%" alt="Filter tool">
+
+The following components make up the filter tool.
+
+- The {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) icon (A) provides a drop-down menu of filter options.
+- The filter list (B) shows the currently defined filters.
+- {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/add-filter-icon.png" class="inline-icon" alt="add filter icon"/>{:/} (circle-plus) **Add filter** (C) provides a popover menu for adding data filters.
+
+## Adding a filter
+
+To add a filter using the **Add filter** tool, follow these steps:
+
+1. Select {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/add-filter-icon.png" class="inline-icon" alt="add filter icon"/>{:/} (add) **Add filter**.
+
+1. In the **Edit filter** popover, choose a data field.
+
+<img src="{{site.url}}{{site.baseurl}}/images/dashboards/edit-filter-popover-filled.png" alt="Edit filter popover"  width="79%">
+
+1. In the **Operator** field, choose an operator.
+
+   The **Operator** dropdown choices are determined by the chosen data field's type.
+   {: .note}
+
+   The Value field appears if needed.
+
+1. If required, in the **Value** field, enter or select a value.
+
+   The **Value** entry mode and choices are determined by the chosen operator and data field type.
+   {: .note}
+
+1. (Optional) Choose **Create custom label?**.
+
+   The custom label replaces the default label composed of the data field name and operator.
+
+1. Select **Save**.
+
+## Editing a filter
+
+To change an existing filter, follow these steps:
+
+1. Select the filter in the filter list.
+
+1. In the filter dropdown, select **Edit filter>**.
+
+1. In the **Edit filter** popover, change the **Field**, **Operator**, or **Values** as needed.
+
+1. (Optional) Add or change the **Custom label**.
+
+1. Select **Save**.
+
+
+## Removing a filter
+
+To remove a filter, choose the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/cross-icon.png" class="inline-icon" alt="cross icon"/>{:/} (cross) icon to the right of the filter name.
+
+## Disabling a filter
+
+You can disable a filter temporarily without removing it from the filter list. To disable a filter, follow these steps:
+
+1. Select the filter in the filter list.
+
+1. In the filter dropdown, select **Temporarily disable**.
+
+   Disabled filter names are shown in ~~strikethrough~~ text.
+   {: .note}
+
+## Re-enabling a filter
+
+To enable a disabled filter, follow these steps:
+
+1. Select a ~~disabled~~ filter in the filter list.
+
+1. In the filter dropdown, select **Re-enable**.
+
+
+## Pinning a filter
+
+You can pin a filter so that it applies to all the applications in OpenSearch Dashboards (Discover, Dashboards, and Visualize). To pin a filter, follow these steps:
+
+1. Select the filter in the filter list.
+
+1. In the filter dropdown, select **Pin across all apps**.
+
+
+## Unpinning a filter
+
+To unpin a filter that has been pinned to all apps, follow these steps:
+
+1. Select the filter in the filter list.
+
+1. In the filter dropdown, select **Unpin**.
+
+
+## Modifying all filters as a group
+
+You can use the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) **Filters** pulldown to change all the filters at once in several ways.
+
+Modifications made with the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) **Filters** pulldown apply only to the filters in the filter list, not to the query in the **Search** bar or to the time filter.
+{: .note}
+
+### Enabling or disabling all the filters
+
+To enable or disable all filters, follow these steps:
+
+1. Select the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) icon.
+
+1. In the **Filters** pulldown, select **Enable all** or **Disable all**.
+
+
+### Inverting which filters are enabled
+
+To exclude all included filters and include all excluded filters, follow these steps:
+
+1. Select the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) icon.
+
+1. In the **Filters** pulldown, select **Invert enabled/disabled**.
+
+
+### Inverting the sense of inclusion for all filters
+
+To negate all filter expressions so that all included documents are excluded and all excluded documents are included, follow these steps:
+
+1. Select the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) icon.
+
+1. In the **Filters** pulldown, select **Invert inclusion**.
+
+   Exclusion filters have **NOT** appended to their title, as shown following. Inverting inclusion a second time removes the **NOT** modifier.
+
+   <img src="{{site.url}}{{site.baseurl}}/images/dashboards/excluded-filter.png" alt="Exclusion filter"  width="36%">
+
+   Disabled filters are inverted, but remain disabled.
+   {: .note}
+
+### Pinning or unpinning all filters
+
+To pin or unpin all filters in all OpenSearch Dashboards applications (Discover, Dashboards, and Visualize), follow these steps:
+
+1. Select the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) icon.
+
+1. In the **Filters** pulldown, select **Pin all** or **Unpin all**.
+
+
+### Removing all filters
+
+To remove all filters from the filter list, follow these steps:
+
+1. Select the {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/funnel-icon.png" class="inline-icon" alt="filter menu icon"/>{:/} (funnel) icon.
+
+1. In the **Filters** pulldown, select **Remove all**.