From 54a34981b0b49d1e7766cbd2162e6c5a6626ce4c Mon Sep 17 00:00:00 2001
From: Florian Hotze <dev@florianhotze.com>
Date: Mon, 13 Jan 2025 13:11:39 +0100
Subject: [PATCH] Rule edit: Add descriptions to triggers, actions & conditions
 sections (#3008)

Closes https://github.com/openhab/openhab-core/issues/4503.

Signed-off-by: Florian Hotze <dev@florianhotze.com>
---
 .../src/pages/settings/rules/rule-edit.vue    | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/bundles/org.openhab.ui/web/src/pages/settings/rules/rule-edit.vue b/bundles/org.openhab.ui/web/src/pages/settings/rules/rule-edit.vue
index 30545312de..14f481487e 100644
--- a/bundles/org.openhab.ui/web/src/pages/settings/rules/rule-edit.vue
+++ b/bundles/org.openhab.ui/web/src/pages/settings/rules/rule-edit.vue
@@ -99,9 +99,14 @@
               </f7-button>
             </div>
             <div v-for="section in ['triggers', 'actions', 'conditions']" :key="section">
-              <f7-block-title medium style="margin-bottom: var(--f7-list-margin-vertical)" v-if="isEditable || rule[section].length > 0">
-                {{ SECTION_LABELS[section][0] }}
-              </f7-block-title>
+              <template v-if="isEditable || rule[section].length > 0">
+                <f7-block-title medium class="no-margin-bottom">
+                  {{ SECTION_LABELS[section][0] }}
+                </f7-block-title>
+                <f7-block-footer class="no-margin-top margin-horizontal" style="margin-bottom: var(--f7-list-margin-vertical)">
+                  {{ SECTION_LABELS[section][1] }}
+                </f7-block-footer>
+              </template>
               <f7-list sortable swipeout media-list @sortable:sort="(ev) => reorderModule(ev, section)">
                 <f7-list-item media
                               :title="mod.label || suggestedModuleTitle(mod, null, section)"
@@ -118,7 +123,7 @@
                 </f7-list-item>
               </f7-list>
               <f7-list v-if="isEditable">
-                <f7-list-item link no-chevron media-item :color="($theme.dark) ? 'black' : 'white'" :subtitle="SECTION_LABELS[section][1]" @click="addModule(section)">
+                <f7-list-item link no-chevron media-item :color="($theme.dark) ? 'black' : 'white'" :subtitle="SECTION_LABELS[section][2]" @click="addModule(section)">
                   <f7-icon slot="media" color="green" aurora="f7:plus_circle_fill" ios="f7:plus_circle_fill" md="material:control_point" />
                 </f7-list-item>
                 <!-- <f7-list-button :color="(showModuleControls) ? 'gray' : 'blue'" :title="sectionLabels[section][1]"></f7-list-button> -->
@@ -202,9 +207,9 @@ export default {
   data () {
     return {
       SECTION_LABELS: {
-        triggers: ['When', 'Add Trigger'],
-        actions: ['Then', 'Add Action'],
-        conditions: ['But only if', 'Add Condition']
+        triggers: ['When', 'Events that cause this rule to run', 'Add Trigger'],
+        actions: ['Then', 'Actions to take when this rule runs', 'Add Action'],
+        conditions: ['But only if', 'Conditions that must be matched for the actions of this rule to run', 'Add Condition']
       },
 
       ready: false,