diff --git a/core/src/main/java/io/grpc/Channel.java b/core/src/main/java/io/grpc/Channel.java
index 00bac03957..8768d2d01f 100644
--- a/core/src/main/java/io/grpc/Channel.java
+++ b/core/src/main/java/io/grpc/Channel.java
@@ -49,7 +49,7 @@ public abstract class Channel {
   /**
    * Create a {@link ClientCall} to the remote operation specified by the given
    * {@link MethodDescriptor}. The returned {@link ClientCall} does not trigger any remote
-   * behavior until {@link ClientCall#start(ClientCall.Listener, Metadata.Headers)} is
+   * behavior until {@link ClientCall#start(ClientCall.Listener, Metadata)} is
    * invoked.
    *
    * @param methodDescriptor describes the name and parameter types of the operation to call.
diff --git a/core/src/main/java/io/grpc/MethodDescriptor.java b/core/src/main/java/io/grpc/MethodDescriptor.java
index 2d4c67b322..19adbc7025 100644
--- a/core/src/main/java/io/grpc/MethodDescriptor.java
+++ b/core/src/main/java/io/grpc/MethodDescriptor.java
@@ -86,7 +86,7 @@ public class MethodDescriptor<RequestT, ResponseT> {
 
     /**
      * 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.Headers)}
+     * 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()}.
      */
     public final boolean clientSendsOneMessage() {