diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java
index 127cb3c01f7..81a07b2cf63 100644
--- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java
+++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java
@@ -63,7 +63,8 @@ import org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMappi
  * {@link #setUseRegisteredSuffixPatternMatch(boolean) useRegisteredSuffixPatternMatch}
  * were deprecated in order to discourage use of path extensions for request
  * mapping and for content negotiation (with similar deprecations in
- * {@link ContentNegotiationManager}). For further context, please read issue
+ * {@link org.springframework.web.accept.ContentNegotiationManagerFactoryBean
+ * ContentNegotiationManagerFactoryBean}). For further context, please read issue
  * <a href="https://github.com/spring-projects/spring-framework/issues/24179">#24719</a>.
  *
  * @author Arjen Poutsma
diff --git a/spring-webmvc/src/main/resources/org/springframework/web/servlet/config/spring-mvc.xsd b/spring-webmvc/src/main/resources/org/springframework/web/servlet/config/spring-mvc.xsd
index 398247f4f91..0c0671c0c01 100644
--- a/spring-webmvc/src/main/resources/org/springframework/web/servlet/config/spring-mvc.xsd
+++ b/spring-webmvc/src/main/resources/org/springframework/web/servlet/config/spring-mvc.xsd
@@ -36,7 +36,14 @@
 								<xsd:documentation><![CDATA[
 	Whether to use suffix pattern match (".*") when matching patterns to requests. If enabled
 	a method mapped to "/users" also matches to "/users.*".
-	The default value is true.
+
+	In 5.2.4, suffix pattern matching was deprecated in order to discourage use of path
+	extensions for request mapping and for content negotiation (see deprecation notes on
+	org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping and on
+	org.springframework.web.accept.ContentNegotiationManagerFactoryBean and
+	also see https://github.com/spring-projects/spring-framework/issues/24179.
+
+	The default value is true but in 5.3 it changes to false.
 								]]></xsd:documentation>
 							</xsd:annotation>
 						</xsd:attribute>
@@ -56,6 +63,13 @@
 	explicitly registered when you configure content negotiation.
 	This is generally recommended to reduce ambiguity and to
 	avoid issues such as when a "." appears in the path for other reasons.
+
+	In 5.2.4, suffix pattern matching was deprecated in order to discourage use of path
+	extensions for request mapping and for content negotiation (see deprecation notes on
+	org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping and on
+	org.springframework.web.accept.ContentNegotiationManagerFactoryBean and
+	also see https://github.com/spring-projects/spring-framework/issues/24179.
+
 	The default value is false.
 								]]></xsd:documentation>
 							</xsd:annotation>