diff --git a/spring-web/src/main/java/org/springframework/http/ReactiveHttpOutputMessage.java b/spring-web/src/main/java/org/springframework/http/ReactiveHttpOutputMessage.java
index cba8f1a4732..4568beea8dd 100644
--- a/spring-web/src/main/java/org/springframework/http/ReactiveHttpOutputMessage.java
+++ b/spring-web/src/main/java/org/springframework/http/ReactiveHttpOutputMessage.java
@@ -53,7 +53,7 @@ public interface ReactiveHttpOutputMessage extends HttpMessage {
 	 * Use the given {@link Publisher} to write the body of the message to the underlying
 	 * HTTP layer.
 	 * @param body the body content publisher
-	 * @return a publisher that indicates completion or error.
+	 * @return a {@link Mono} that indicates completion or error
 	 */
 	Mono<Void> writeWith(Publisher<DataBuffer> body);
 
@@ -62,7 +62,7 @@ public interface ReactiveHttpOutputMessage extends HttpMessage {
 	 * message to the underlying HTTP layer, flushing after each
 	 * {@code Publisher<DataBuffer>}.
 	 * @param body the body content publisher
-	 * @return a publisher that indicates completion or error.
+	 * @return a {@link Mono} that indicates completion or error
 	 */
 	Mono<Void> writeAndFlushWith(Publisher<Publisher<DataBuffer>> body);
 
@@ -74,6 +74,7 @@ public interface ReactiveHttpOutputMessage extends HttpMessage {
 	 * <p>This method should be automatically invoked at the end of message
 	 * processing so typically applications should not have to invoke it.
 	 * If invoked multiple times it should have no side effects.
+	 * @return a {@link Mono} that indicates completion or error
 	 */
 	Mono<Void> setComplete();
 
diff --git a/spring-web/src/main/java/org/springframework/http/codec/HttpMessageWriter.java b/spring-web/src/main/java/org/springframework/http/codec/HttpMessageWriter.java
index 15538df4ad8..a5217b70801 100644
--- a/spring-web/src/main/java/org/springframework/http/codec/HttpMessageWriter.java
+++ b/spring-web/src/main/java/org/springframework/http/codec/HttpMessageWriter.java
@@ -58,7 +58,7 @@ public interface HttpMessageWriter<T> {
 	 * type of the converter must be used.
 	 * @param outputMessage the message to write to
 	 * @param hints additional information about how to write
-	 * @return the converted {@link Mono} of object
+	 * @return a {@link Mono} that indicates completion or error
 	 */
 	Mono<Void> write(Publisher<? extends T> inputStream, ResolvableType elementType,
 			MediaType mediaType, ReactiveHttpOutputMessage outputMessage, Map<String, Object> hints);