diff --git a/core/src/main/java/io/grpc/AbstractChannelBuilder.java b/core/src/main/java/io/grpc/AbstractChannelBuilder.java
index 17ff0d0161..c4e66f8398 100644
--- a/core/src/main/java/io/grpc/AbstractChannelBuilder.java
+++ b/core/src/main/java/io/grpc/AbstractChannelBuilder.java
@@ -180,5 +180,10 @@ public abstract class AbstractChannelBuilder<BuilderT extends AbstractChannelBui
     }
   }
 
+  /**
+   * Children of AbstractChannelBuilder should override this method to provide transport specific
+   * information for the channel.  This method is mean for Transport implementors and should not be
+   * used by normal users.
+   */
   protected abstract ChannelEssentials buildEssentials();
 }