diff --git a/core/src/main/java/com/linecorp/armeria/common/logging/RequestLogBuilder.java b/core/src/main/java/com/linecorp/armeria/common/logging/RequestLogBuilder.java
index 6b1badfb1a9..61915cfaaa6 100644
--- a/core/src/main/java/com/linecorp/armeria/common/logging/RequestLogBuilder.java
+++ b/core/src/main/java/com/linecorp/armeria/common/logging/RequestLogBuilder.java
@@ -109,12 +109,16 @@ void session(@Nullable Channel channel, SessionProtocol sessionProtocol, @Nullab
      *    <li>A path pattern and HTTP method name for {@link HttpService}</li>
      * </ul>
      * This property is often used as a meter tag or distributed trace's span name.
+     * Note that calling {@link #responseContent(Object, Object)} will automatically fill
+     * {@link RequestLogProperty#NAME}, so {@link #name(String, String)} must be called beforehand.
      */
     void name(String serviceName, String name);
 
     /**
      * Sets the human-readable name of the {@link Request}, such as RPC method name, annotated service method
      * name or HTTP method name. This property is often used as a meter tag or distributed trace's span name.
+     * Note that calling {@link #responseContent(Object, Object)} will automatically fill
+     * {@link RequestLogProperty#NAME}, so {@link #name(String)} must be called beforehand.
      */
     void name(String name);