--- a/doc/book/devweb/ajax.rst	Fri Jan 31 16:25:14 2020 +0100
+++ b/doc/book/devweb/ajax.rst	Fri Jan 31 16:31:44 2020 +0100
@@ -3,6 +3,17 @@
 Ajax
 ----
 
+.. warning::
+
+    This approach is deprecated in favor of using
+    `cwclientlibjs <https://www.npmjs.com/package/@logilab/cwclientlibjs>`_.
+    If your use react for your UI, try the react components from the
+    `cwelements <https://www.npmjs.com/package/@logilab/cwelements>`_ library.
+    The documentation is kept here as reference.
+
+    For historical reference of what Ajax is and used to be, one can read the
+    `wikipedia article about Ajax <https://en.wikipedia.org/wiki/Ajax_(programming)>`_.
+
 CubicWeb provides a few helpers to facilitate *javascript <-> python* communications.
 
 You can, for instance, register some python functions that will become