diff -r c46f2bf815d2 -r 36f1c7ab9010 doc/book/pyramid/settings.rst
--- a/doc/book/pyramid/settings.rst	Thu Apr 27 10:16:39 2017 +0200
+++ b/doc/book/pyramid/settings.rst	Tue Jun 06 12:20:17 2017 +0200
@@ -76,7 +76,10 @@
 
 .. confval:: cubicweb.bwcompat (bool)
 
-    (True) Enable/disable backward compatibility. See :ref:`bwcompat_module`.
+    (True) Enable/disable backward compatibility. This only applies to
+    "all-in-one" configuration type.
+
+    See :ref:`bwcompat_module`.
 
 .. confval:: cubicweb.bwcompat.errorhandler (bool)