fixed feedback comments

Author: ketkee-aryamane

explore-analyze/toc.yml

@@ -99,7 +99,6 @@ toc:
         children:
           - file: query-filter/tools/saved-queries.md
           - file: query-filter/tools/console.md
-          - file: query-filter/tools/query-rules-gui.md
           - file: query-filter/tools/search-profiler.md
           - file: query-filter/tools/grok-debugger.md
           - file: query-filter/tools/playground.md

explore-analyze/images/elasticsearch-query-rules-create-rule.png renamed to solutions/images/elasticsearch-query-rules-create-rule.png

@@ -2,10 +2,12 @@
 applies_to:
   stack: ga 9.1
   serverless: ga
+  elasticsearch:
 ---
-# Query rules GUI
 
-Query rules GUI is a user interface that helps you create, edit, and delete query rules. The interface is implemented on top of the existing Query Rules API and provides non-technical users with an intuitive, streamlined interface to manage query rules.
+# Query rules UI
+
+Query rules UI is a user interface that helps you create, edit, and delete query rules. The interface is implemented on top of the existing Query Rules API and provides non-technical users with an intuitive, streamlined interface to manage query rules.
 
 Query rules help customize search results, giving you more control over how results are returned based on the contextual information in the query.
 
@@ -14,31 +16,33 @@ The Query rules UI enables you to:
 * Create, edit and delete query rules
 * Reorder rules in a query ruleset
 
-If you'd still prefer to use the Query Rules API, refer to [Query Rules API](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-query_rules).
-For examples how to search using query rules, refer [Search using Query Rules API](https://www.elastic.co/docs/reference/elasticsearch/rest-apis/searching-with-query-rules).
+## UI vs. API: What's the difference?
+
+All the functionality in the UI works the same as in API calls. The only difference is that the Query Rules UI will create pinning by `docs` over `ids`. It'll still allow edits in a simple form for `id` pinning. For more information on Rule actions, refer [Rule actions](https://www.elastic.co/docs/reference/elasticsearch/rest-apis/searching-with-query-rules#query-rule-actions).
+
+To see examples of how to search using query rules, refer [Search using Query Rules API](https://www.elastic.co/docs/reference/elasticsearch/rest-apis/searching-with-query-rules).
+
+If you prefer to use the Query Rules API, refer to [Query Rules API](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-query_rules).
 
 ## Security privileges
 
-If you want to get full access to the Query Rules GUI, you must have the following privileges:
+If you want to get full access to the Query Rules UI, you must have the following privileges:
 
 * Appropriate roles to access Kibana. For more information, refer to [Built-in roles](https://www.elastic.co/docs/deploy-manage/users-roles/cluster-or-deployment-auth/built-in-roles) or  [Kibana privileges](https://www.elastic.co/docs/deploy-manage/users-roles/cluster-or-deployment-auth/kibana-privileges)
 * A custom role with `manage_search_query_rules` cluster privilege
 * `ALL` option for `Query Rules` role privilege in the respective Kibana space
 
-## GUI vs. API: What's the difference?
+## Using the UI
 
-All the functionality in the GUI works the same as in API calls. The only difference is that the Query Rules GUI will create pinning by `docs` over `ids`. It'll still allow edits in a simple form for `id` pinning. For more information on Rule actions, refer [Rule actions](https://www.elastic.co/docs/reference/elasticsearch/rest-apis/searching-with-query-rules#query-rule-actions).
+Go to your deployment and select **Query Rules** from the left navigation menu. If you're not able to see the option, contact the administrator to review the role assigned to you. The following screenshot shows the UI for a new deployment setup.
 
-## Using the GUI
-
-Go to your deployment and select **Query Rules** from the left navigation menu. If you're not able to see the option, contact the administrator to review the role assigned to you. The following screenshot shows the GUI for a new deployment setup.
-
-:::{image} /explore-analyze/images/query-rules-gui-home.png
-:alt: Landing page for Query Rules GUI.
+:::{image} /solutions/images/elasticsearch-query-rules-ui-home.png
+:alt: Landing page for Query Rules UI.
 :screenshot:
 :::
 
 ### Create a query rule
+Use the following steps to first create a query ruleset, and then a query rule:
 
 1. Select **Query Rules** in the navigation menu under **Relevance**.
 2. Select **Create ruleset**:
@@ -62,20 +66,23 @@ Go to your deployment and select **Query Rules** from the left navigation menu.
 Each ruleset must contain at least one rule.
 :::
 
-:::{image} /explore-analyze/images/elasticsearch-query-rules-create-rule.png
+:::{image} /solutions/images/elasticsearch-query-rules-create-rule.png
 :alt: Creating a query rule.
 :screenshot:
 :::
 
 ### Delete a ruleset
+Use the following steps to delete a query ruleset:
 1. Select **Query Rules** in the navigation menu under **Relevance**.
 2. Select **Delete** or select it from the action menu (**...**).
 3. Select if the ruleset is safe to delete.
 4. Select **Delete ruleset**.
 
 ### Manage existing rules
+The following sections describe how to edit, delete, and re-order rules:
 
 #### Edit a rule
+Use the following steps to edit a query rule:
 1. Select **Query Rules** in the navigation menu under **Relevance**.
 2. Select a ruleset.
 3. Select **Edit** from the action menu (**...**).
@@ -89,22 +96,23 @@ Unsaved rules will not be applied even if they're displayed in the UI.
 :::
 
 #### Delete a rule
+Use the following steps to delete a query rule:
 1. Select **Query Rules** in the navigation menu under **Relevance**.
 2. Select a ruleset.
 3. Select **Delete rule** from the action menu (**...**)
 4. Select **Delete rule**.
 5. Select **Save** in the top right corner of the ruleset section.
 
 #### Re-order rules
-
+Use the following steps to re-order query rules:
 1. Select **Query Rules** in the navigation menu under **Relevance**.
 2. Select a ruleset.
 3. Drag a rule using the handle icon (≡) on the left.
 4. Drop it in the new position.
 5. Select **Save** in the top right corner of the ruleset section.
 
 ### Test and validate a ruleset
-
+To test a query ruleset, do the following:
 1. Select **Query Rules** in the navigation menu under **Relevance**.
 2. Select a ruleset.
 3. Select **Test in Console**.

explore-analyze/images/query-rules-gui-home.png renamed to solutions/images/elasticsearch-query-rules-ui-home.png

@@ -89,6 +89,7 @@ toc:
               - file: search/search-applications/search-application-client.md
       - file: search/apis-and-tools.md
       - file: search/ai-assistant.md
+      - file: search/query-rules-ui.md
   - file: observability.md
     children:
       - file: observability/get-started.md