diff --git a/docs/formatnode.html.in b/docs/formatnode.html.in
index 5c7286df8a..c58cd01395 100644
--- a/docs/formatnode.html.in
+++ b/docs/formatnode.html.in
@@ -379,7 +379,10 @@
                 This optional element can occur multiple times. It represents a
                 vendor-specific attribute that is used to configure this
                 mediated device. It has two required attributes:
-                <code>name</code> and <code>value</code>.
+                <code>name</code> and <code>value</code>. Note that the order
+                in which attributes are set may be important for some devices.
+                The order that they appear in the xml definition determines the
+                order that they will be written to the device.
               </dd>
             </dl>
           </dd>