doc: DoH without TLS or over HTTP 1 is deprecated

diff --git a/doc/upgrading.rst b/doc/upgrading.rst
index f00435accd2f2ce07816d13b8fac75e95577fa68..e243bf9128b22c95beef114530050ef19bf7baba 100644 (file)
--- a/doc/upgrading.rst
+++ b/doc/upgrading.rst
@@ -29,7 +29,9 @@ Users
   the human readable output. For example API call ``tojson(cache.stats())\n`` will return JSON string
   with ``cache.stats()`` results represented as dictionary.
   Function ``tojson()`` is available in all resolver versions >= 1.0.0.
-
+* DoH served with http module :ref:`DNS-over-HTTP (DoH) <mod-http-doh>` will be marked as legacy
+  and won't receive any more bugfixes. A more reliable and scalable DoH module will be available
+  instead. The new DoH module will only support HTTP/2 over TLS.
 
 5.0 to 5.1
 ==========