diff --git a/doc/src/sgml/release-10.sgml b/doc/src/sgml/release-10.sgml
index 1a9110614d..015d441376 100644
--- a/doc/src/sgml/release-10.sgml
+++ b/doc/src/sgml/release-10.sgml
@@ -508,6 +508,12 @@
 
    </itemizedlist>
 
+   <para>
+    Installations using MD5 authentication are encouraged to switch to
+    SCRAM-SHA-256, unless using older client programs or drivers that don't
+    support it yet.
+   </para>
+
   </sect2>
 
   <sect2>