stateDescription: change to read-write

[dilyanpalauzov]

This takes the text from openhab/openhab-addons#18362 (comment) and extends the documentation, telling the user how an item, bound to read-only channel, can be made read-write.

However I have experience only with MQTT and there CommandTopic applies. For other things CommandTopic might not be adequate.

[netlify]

✅ Thanks for your pull request to the openHAB documentation! The result can be previewed at the URL below (this comment and the preview will be updated if you add more commits).

Built without sensitive environment variables

Name	Link
🔨 Latest commit	27c5786
🔍 Latest deploy log	https://app.netlify.com/sites/openhab-docs-preview/deploys/681f114377d56b0008a615df
😎 Deploy Preview	https://deploy-preview-2487--openhab-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[dilyanpalauzov]

I do not think that the failure to generate the documentation at Netlify is in this change.

[wborn]

I also ran into the failing preview build and created #2491 to fix it.

[florian-h05]

This sentence is wrong. Item editing does not depend on the state description.

[dilyanpalauzov]

In OH-Android it does depend - openhab/openhab-android#3870.

[florian-h05]

I think your wording is wrong and hence we are talking about different things.
Item editing is actually modifying the config. You mean sending commands, not editing.

[dilyanpalauzov]

I changed it:

@@ -275,7 +275,7 @@ Location  My_Location              "My Location [%2$s°N %3$s°E %1$sm]" // e.g.
 
 Internally items have a State Description, which can be obtained by GET `/rest/items/<itemName>`.
 When an item is linked to a channel without `CommandTopic`, the State Description of the item is read-only.
-Some UIs may disallow the user to edit such an item.
+Some UIs may disallow the user to send commands to such an item.
 To change the item to read-write add `stateDescription=" "[readOnly=false]` in bindingconfig.
 
 #### State Transformation