diff --git a/docs/conf/modules.example.conf b/docs/conf/modules.example.conf
index 6483793f4..e6aff5dd2 100644
--- a/docs/conf/modules.example.conf
+++ b/docs/conf/modules.example.conf
@@ -426,9 +426,10 @@
 
 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 # MD5 cloak module: Adds the "half" and "full" cloak methods. These
-# methods are obsolete and should only be used on a network which is
-# upgrading from v3 and wishes to keep ban compatibility. New networks
-# should should use the "hmac-sha256" method (see below) instead.
+# methods are deprecated and will be removed in the next major version
+# of InspIRCd. They should only be used on a network which is upgrading
+# from v3 and wishes to keep ban compatibility. New networks should use
+# the "hmac-sha256" method (see below) instead.
 #
 # IMPORTANT: If you are using this module you should also load the md5
 # module. Failure to do so will result in users not being cloaked.
@@ -1602,7 +1603,8 @@
 
 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 # MD5 module: Allows other modules to generate MD5 hashes, usually for
-# cryptographic uses and security.
+# cryptographic uses and security. This module is deprecated and will
+# be removed in the next major version of InspIRCd.
 #
 # IMPORTANT:
 # Other modules such as cloak_md5 and password_hash may rely on