diff --git a/lib/xos-config/xosconfig/default.py b/lib/xos-config/xosconfig/default.py
index f1a7adc..61829ba 100644
--- a/lib/xos-config/xosconfig/default.py
+++ b/lib/xos-config/xosconfig/default.py
@@ -16,6 +16,13 @@
 
 DEFAULT_VALUES = {
     'xos_dir': '/opt/xos',
+
+    # The configuration below inherits from the standard config of the Python logging module
+    # See: https://docs.python.org/2/library/logging.config.html
+    # multistructlog supports this config in all of its generality
+    # So for instance, you can add new handlers. Note that all handlers will
+    # receive logs simultaneously.
+
     'logging': {
         'version': 1,
         'handlers': {
diff --git a/lib/xos-config/xosconfig/xos-config-schema.yaml b/lib/xos-config/xosconfig/xos-config-schema.yaml
index 216bbf1..d897e76 100644
--- a/lib/xos-config/xosconfig/xos-config-schema.yaml
+++ b/lib/xos-config/xosconfig/xos-config-schema.yaml
@@ -31,7 +31,12 @@
       password:
         type: str
         required: True
-  logging: 
+  # The configuration below inherits from the standard config of the Python logging module
+  # See: https://docs.python.org/2/library/logging.config.html
+  # multistructlog supports this config in all of its generality
+  # So for instance, you can add new handlers. Note that all handlers will
+  # receive logs simultaneously.
+  logging:
     type: any
   xos_dir:
     type: str