# HG changeset patch
# User Laurent Peuch <cortex@worlddomination.be>
# Date 1575509174 -3600
# Node ID 45242ceec2129ed1b9d32a54cd094d4cdc8ea26b
# Parent  00c14fb7c93146a50691c0a2051eebfe2022ce77
[changelog] add information about the new debug html attributes

diff -r 00c14fb7c931 -r 45242ceec212 doc/changes/3.27.rst
--- a/doc/changes/3.27.rst	Thu Dec 05 02:12:20 2019 +0100
+++ b/doc/changes/3.27.rst	Thu Dec 05 02:26:14 2019 +0100
@@ -50,6 +50,28 @@
 * allow to specify the instance id for any instance command using the
   CW_INSTANCE global variable instead of or giving it as a cli argument
 
+* when debugmode is activated ('-D/--debug' on the pyramid command for
+  example), the HTML generated by CW will contains new tags that will indicate
+  by which object in the code it has been generated and in which line of which
+  source code.
+  For example:
+
+.. code-block:: html
+
+    <div
+      cubicweb-generated-by="cubicweb.web.views.basetemplates.TheMainTemplate"
+      cubicweb-from-source="/home/user/code/logilab/cubicweb/cubicweb/web/views/basetemplates.py:161"
+      id="contentmain">
+        <h1
+          cubicweb-generated-by="cubicweb.web.views.basetemplates.TheMainTemplate"
+          cubicweb-from-source="/home/user/code/logilab/cubicweb/cubicweb/view.py:136">
+            unset title
+        </h1>
+        [...]
+    </div>
+
+While this hasn't been done yet, this feature is an open path for building dynamic tools that can help inspect the page.
+
 * add a new '-t/--toolbar' option the pyramid command to activate the pyramid debugtoolbar
 
 * a series of pyramid debugtoolbar panels specifically made for CW, see bellow