Docs updates

docs/administration-faq.rst

@@ -0,0 +1,28 @@
+.. _administration-faq:
+
+Administration FAQ
+==================
+
+.. topic:: Duplicate log entries when using log() function
+
+  Because GenieACS uses a full fledged scripting language for device
+  configuration, the only way to guarantee that it has satisfied the 'desired
+  state' is by repeatedly executing the script until there's no more
+  discrepancies with the current device state. Though it may seem like this
+  will cause duplicate requests going to the device, this isn't actually the
+  case because device configuration are stated declaratively and that the
+  scripts themselves are pure functions in the context of a session (e.g.
+  Date.now() always returns the same value within the session).
+
+  To illustrate further, consider following script:
+
+  .. code:: javascript
+
+    declare("Device.param", null, {value: 1});
+    commit();
+    declare("Device.param", null, {value: 2});
+
+  This will set the value of the 'Device.param' to 1, then to 2. Then as the
+  script is run again the value is set back to 1 and so on. A stable state will
+  never be reached so GenieACS will execute the script a few times until it
+  gives up and throws a fault.