diff --git a/spring-web/src/main/java/org/springframework/http/codec/xml/XmlEventDecoder.java b/spring-web/src/main/java/org/springframework/http/codec/xml/XmlEventDecoder.java
index 696f470c52..4971353b99 100644
--- a/spring-web/src/main/java/org/springframework/http/codec/xml/XmlEventDecoder.java
+++ b/spring-web/src/main/java/org/springframework/http/codec/xml/XmlEventDecoder.java
@@ -47,17 +47,19 @@ import org.springframework.util.MimeTypeUtils;
 import org.springframework.util.xml.StaxUtils;
 
 /**
- * Decodes a {@link DataBuffer} stream into a stream of {@link XMLEvent DataBuffer} stream into a stream of {@link XMLEvents}.
- * That is, given the following XML:
+ * Decodes a {@link DataBuffer} stream into a stream of {@link XMLEvent XMLEvents}.
  *
- * <pre>
+ * <p>Given the following XML:
+ *
+ * <pre class="code">
  * &lt;root>
  *     &lt;child&gt;foo&lt;/child&gt;
  *     &lt;child&gt;bar&lt;/child&gt;
  * &lt;/root&gt;
  * </pre>
  *
- * this method with result in a flux with the following events:
+ * this decoder will produce a {@link Flux} with the following events:
+ *
  * <ol>
  * <li>{@link javax.xml.stream.events.StartDocument}</li>
  * <li>{@link javax.xml.stream.events.StartElement} {@code root}</li>
@@ -70,8 +72,8 @@ import org.springframework.util.xml.StaxUtils;
  * <li>{@link javax.xml.stream.events.EndElement} {@code root}</li>
  * </ol>
  *
- * Note that this decoder is not registered by default but used internally
- * by other decoders who are there by default.
+ * <p>Note that this decoder is not registered by default but is used internally
+ * by other decoders which are registered by default.
  *
  * @author Arjen Poutsma
  * @since 5.0
diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/config/annotation/WebMvcConfigurer.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/config/annotation/WebMvcConfigurer.java
index edd833da08..46269f7e31 100644
--- a/spring-webmvc/src/main/java/org/springframework/web/servlet/config/annotation/WebMvcConfigurer.java
+++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/config/annotation/WebMvcConfigurer.java
@@ -82,7 +82,7 @@ public interface WebMvcConfigurer {
 	}
 
 	/**
-	 * Add {@link Converter}s and {@link Formatter Converter}s and {@link Formatters} in addition to the ones
+	 * Add {@link Converter Converters} and {@link Formatter Formatters} in addition to the ones
 	 * registered by default.
 	 */
 	default void addFormatters(FormatterRegistry registry) {