diff --git a/fhem/docs/commandref_frame.html b/fhem/docs/commandref_frame.html
index 369ad4837..b6ba64198 100644
--- a/fhem/docs/commandref_frame.html
+++ b/fhem/docs/commandref_frame.html
@@ -1947,8 +1947,11 @@ The following local attributes are used by a wider range of devices:
     <br>
     <ul>
       <li>Value(&lt;devicename&gt;)<br>
-        Returns the state of the device (the string you see in parenthesis in
-        the output of the list command).
+        Returns the STATE of the device (the string you see in parenthesis in
+        the output of the list command). Note: STATE is meant for display
+        purposes, and can be customized by the user via the stateFormat
+        attribute. Use ReadingsVal(&lt;devicename&gt;, 'state', '') instead for
+        computational purposes.
         </li><br>
       <li>OldValue(&lt;devicename&gt;)
       <li>OldTimestamp(&lt;devicename&gt;)<br>
diff --git a/fhem/docs/commandref_frame_DE.html b/fhem/docs/commandref_frame_DE.html
index 7dff88a89..758bb8b5f 100644
--- a/fhem/docs/commandref_frame_DE.html
+++ b/fhem/docs/commandref_frame_DE.html
@@ -2092,8 +2092,11 @@ Die folgenden lokalen Attribute werden von mehreren Ger&auml;ten verwendet:
     <br>
     <ul>
       <li>Value(&lt;devicename&gt;)<br>
-        liefert das Internal STATE zur&uuml;ck.
-        </li><br>
+        liefert das Internal STATE zur&uuml;ck. Achtung: STATE wird in erster
+        Linie f&uuml;r die Anzeige verwendet, und kann vom Benutzer mit dem
+        stateFormat Attribut ge&auml;ndert werden. F&uuml;r Berechnungen sollte
+        man stattdessen ReadingsVal(&lt;devicename&gt;, 'state', '') verwenden
+        (s.u.).  </li><br>
 
       <li>OldValue(&lt;devicename&gt;)</li>
       <li>OldTimestamp(&lt;devicename&gt;)<br>