diff --git a/api/src/main/java/io/grpc/MethodDescriptor.java b/api/src/main/java/io/grpc/MethodDescriptor.java
index 51c65b08cc..08692592e4 100644
--- a/api/src/main/java/io/grpc/MethodDescriptor.java
+++ b/api/src/main/java/io/grpc/MethodDescriptor.java
@@ -85,7 +85,7 @@ public final class MethodDescriptor<ReqT, RespT> {
     UNARY,
 
     /**
-     * Zero or more request messages followed by one response message.
+     * Zero or more request messages with one response message.
      */
     CLIENT_STREAMING,
 
@@ -106,9 +106,8 @@ public final class MethodDescriptor<ReqT, RespT> {
     UNKNOWN;
 
     /**
-     * Returns {@code true} if the client will immediately send one request message to the server
-     * after calling {@link ClientCall#start(io.grpc.ClientCall.Listener, io.grpc.Metadata)}
-     * and then immediately half-close the stream by calling {@link io.grpc.ClientCall#halfClose()}.
+     * Returns {@code true} for {@code UNARY} and {@code SERVER_STREAMING}, which do not permit the
+     * client to stream.
      *
      * @since 1.0.0
      */
@@ -117,9 +116,8 @@ public final class MethodDescriptor<ReqT, RespT> {
     }
 
     /**
-     * Returns {@code true} if the server will immediately send one response message to the client
-     * upon receipt of {@link io.grpc.ServerCall.Listener#onHalfClose()} and then immediately
-     * close the stream by calling {@link ServerCall#close(Status, io.grpc.Metadata)}.
+     * Returns {@code true} for {@code UNARY} and {@code CLIENT_STREAMING}, which do not permit the
+     * server to stream.
      *
      * @since 1.0.0
      */