alexarc4shng plugin: update metadata with some more information

alexarc4shng/plugin.yaml

@@ -36,15 +36,32 @@ parameters:
         type: str
         default: ''
         description:
-            de: 'Ein Item welches verwendet wird um die Freigabe für die Kommunikation zu erteilen (USZU)'
-            en: 'An Item to give the plugin permission to remote control the echo-devices (USZU)'
+            de: 'Ein Item welches verwendet wird um die Freigabe für die Kommunikation zu erteilen (z.B. via UZSU)'
+            en: 'An Item to give the plugin permission to remote control the echo-devices (e.g. via UZSU)'
+        description_long:
+            de: 'Item, das beispielsweise durch eine Zeitschaltuhr oder etwas anderem geschaltet wird,
+                 um die Kommunikation mit Alexa-Amazon-Geräten zu ermöglichen.
+                 Ist der Wert leer oder nicht angegeben, ist die Kommunikation jederzeit rund um die Uhr aktiviert.
+                 Dieses Item wird nur während update_item in smarthomeNG überprüft. Wenn die API direkt von einer Logik oder
+                 über die Benutzeroberfläche verwendet wird, wird das Item nicht überprüft.'
+            en: 'Item controlled by UZSU or something else which enables the communication to Alexa-Amazon-devices.
+                 If left blank/not configured the communication is enabled all the time 24/7.
+                 This item is only checked during update_item in smarthomeNG.
+                 If you use the API directly from a logic or from the Webinterface the item will not be checked.'
 
     alexa_credentials:
         type: str
         default: ''
         description:
             de: 'Zugangsdaten für das Amazon-Alexa-Web-Site <USER>:<PWD>, base64 encodiert'
             en: 'credentials for the amazon-alexa-website <USER>:<PWD>, base64 encoded'
+        description_long:
+            de: 'Die Zugangsdaten können entweder über der Web Interface kodiert werden oder direkt über eine Python-Konsole mit den zwei Zeilen
+                 import base64
+                 base64.b64encode("[email protected]:your_pwd".encode("utf-8"))'
+            en: 'The access credentials can be encoded either through the web interface or directly via a Python console using the following two lines.
+                 import base64
+                 base64.b64encode("[email protected]:your_pwd".encode("utf-8"))'
 
     login_update_cycle:
         type: num
@@ -80,8 +97,8 @@ plugin_functions:
     send_cmd:
         type: str
         description:
-            de: "Sendet einen Befehl an Alexa."
-            en: "Sends a command to Alexa."
+            de: "Sendet einen Befehl an Alexa. Es können auch Platzhalter genutzt werden. Das Resultat wird der HTTP Status des Requests als String sein."
+            en: "Sends a command to Alexa. Placeholders can be used. The result will be the HTTP-Status of the request as string (str)"
         parameters:
             dvName:
                 type: str
@@ -115,10 +132,9 @@ plugin_functions:
                     - 'TO_DO'
 
 
-            
+
     get_last_alexa:
         type: str
         description:
             de: "Liefert die Geräte-ID des zuletzt verwendeten Alexa-Gerätes zurück"
             en: "delivers the Device-ID of the last used Alexa-Device"
-