Add Debug config chapter

Author: ddeboer

Resources/doc/reference/configuration.rst

@@ -5,38 +5,9 @@ Configuration
     :maxdepth: 2
 
     configuration/proxy-client
-    configuration/rules
     configuration/headers
     configuration/invalidation
     configuration/tags
     configuration/user-context
-    configuration/default
-
-
-
-
-
-Debug Header
-------------
-
-Enable the ``debug`` parameter to set a ``X-Cache-Debug`` header on each
-response. You can then :ref:`configure your caching proxy <foshttpcache:varnish_debugging>`
-to add debug information when that header is present:
-
-.. code-block:: yaml
-
-    # app/config/config.yml
-    fos_http_cache:
-      debug: true
-
-The default value is ``%kernel.debug%``, triggering the header when you are in
-dev mode but not in prod mode. You can change the header with the
-``debug_header`` option:
-
-.. code-block:: yaml
-
-    # app/config/config.yml
-    fos_http_cache:
-      debug_header: Please-Send-Debug-Infos
-
-
+    configuration/flash-message
+    configuration/debug

Resources/doc/reference/configuration/debug.rst

@@ -0,0 +1,32 @@
+Debug Header
+============
+
+Enable the ``debug`` parameter to set a custom header (``X-Cache-Debug``)
+header on each response. You can then
+:ref:`configure your caching proxy <foshttpcache:varnish_debugging>` to add
+debug information when that header is present:
+
+
+.. code-block:: yaml
+
+    # app/config/config.yml
+    fos_http_cache:
+        debug:
+            enabled: true
+            header: Please-Send-Debug-Infos
+
+enabled
+-------
+
+**type**: ``enum`` **default**: ``auto`` **options**: ``true``, ``false``, ``auto``
+
+The default value is ``%kernel.debug%``, triggering the header when you are in
+dev mode but not in prod mode.
+
+header
+------
+
+**type**: ``string`` **default**: ``X-Cache-Debug**
+
+Custom HTTP header that triggers the caching proxy to set debugging information
+on the response.