From 30bbc95506e36f9c61dcfe8adaf3de9be0ed0508 Mon Sep 17 00:00:00 2001
From: jimtng <2554958+jimtng@users.noreply.github.com>
Date: Wed, 29 Mar 2023 16:41:38 +1000
Subject: [PATCH] Clarify the script profile config description (#3506)

Signed-off-by: Jimmy Tanagra <jcode@tanagra.id.au>
---
 .../main/resources/OH-INF/config/script-profile.xml    | 10 ++++++----
 .../resources/OH-INF/i18n/scriptprofile.properties     |  8 ++++----
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/config/script-profile.xml b/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/config/script-profile.xml
index 3fd037165e..cbbfad5bb0 100644
--- a/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/config/script-profile.xml
+++ b/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/config/script-profile.xml
@@ -10,12 +10,14 @@
 			<description>MIME-type ("application/vnd.openhab.dsl.rule") of the scripting language</description>
 		</parameter>
 		<parameter name="toItemScript" type="text">
-			<label>To Item Script</label>
-			<description>The Script for transforming states and commands from handler to item.</description>
+			<label>Thing To Item Transformation</label>
+			<description>The Script for transforming state updates and commands from the Thing handler to the item. The script
+				may return null to discard the updates/commands and not pass them through.</description>
 		</parameter>
 		<parameter name="toHandlerScript" type="text">
-			<label>To Handler Script</label>
-			<description>The Script for transforming states and commands from item to handler.</description>
+			<label>Item To Thing Transformation</label>
+			<description>The Script for transforming commands from the item to the Thing handler. The script may return null to
+				discard the commands and not pass them through.</description>
 		</parameter>
 	</config-description>
 
diff --git a/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/i18n/scriptprofile.properties b/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/i18n/scriptprofile.properties
index 021f533101..ba168b3802 100644
--- a/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/i18n/scriptprofile.properties
+++ b/bundles/org.openhab.core.automation.module.script/src/main/resources/OH-INF/i18n/scriptprofile.properties
@@ -1,6 +1,6 @@
 profile.system.script.scriptLanguage.label = Script Language
 profile.system.script.scriptLanguage.description = MIME-type ("application/vnd.openhab.dsl.rule") of the scripting language
-profile.system.script.toItemScript.label = To Item Script
-profile.system.script.toItemScript.description = The Script for transforming states and commands from handler to item.
-profile.system.script.toHandlerScript.label = To Handler Script
-profile.system.script.toHandlerScript.description = The Script for transforming states and commands from item to handler.
+profile.system.script.toItemScript.label = Thing To Item Transformation
+profile.system.script.toItemScript.description = The Script for transforming state updates and commands from the Thing handler to the item. The script may return null to discard the updates/commands and not pass them through.
+profile.system.script.toHandlerScript.label = Item To Thing Transformation
+profile.system.script.toHandlerScript.description = The Script for transforming commands from the item to the Thing handler. The script may return null to discard the commands and not pass them through.