diff --git a/transport/src/main/java/io/netty/channel/ChannelOutboundInvoker.java b/transport/src/main/java/io/netty/channel/ChannelOutboundInvoker.java
index caaa3fb966..304dc0acd9 100644
--- a/transport/src/main/java/io/netty/channel/ChannelOutboundInvoker.java
+++ b/transport/src/main/java/io/netty/channel/ChannelOutboundInvoker.java
@@ -17,7 +17,11 @@ package io.netty.channel;
 
 import java.net.SocketAddress;
 
+/**
+ * Interface which is shared by others which need to execute outbound logic.
+ */
 public interface ChannelOutboundInvoker {
+
     /**
      * Bind to the given {@link SocketAddress} and notify the {@link ChannelFuture} once the operation completes,
      * either because the operation was successful or because of an error.
diff --git a/transport/src/main/java/io/netty/channel/ChannelPipeline.java b/transport/src/main/java/io/netty/channel/ChannelPipeline.java
index e2a2b81c7a..b9e1c8448c 100644
--- a/transport/src/main/java/io/netty/channel/ChannelPipeline.java
+++ b/transport/src/main/java/io/netty/channel/ChannelPipeline.java
@@ -226,6 +226,8 @@ public interface ChannelPipeline extends ChannelInboundInvoker, ChannelOutboundI
     /**
      * Inserts a {@link ChannelHandler} at the first position of this pipeline.
      *
+     * @param group    the {@link EventExecutorGroup} which will be used to execute the {@link ChannelHandler}
+     *                 methods
      * @param name     the name of the handler to insert first
      * @param handler  the handler to insert first
      *
@@ -252,6 +254,8 @@ public interface ChannelPipeline extends ChannelInboundInvoker, ChannelOutboundI
     /**
      * Appends a {@link ChannelHandler} at the last position of this pipeline.
      *
+     * @param group    the {@link EventExecutorGroup} which will be used to execute the {@link ChannelHandler}
+     *                 methods
      * @param name     the name of the handler to append
      * @param handler  the handler to append
      *
@@ -283,6 +287,8 @@ public interface ChannelPipeline extends ChannelInboundInvoker, ChannelOutboundI
      * Inserts a {@link ChannelHandler} before an existing handler of this
      * pipeline.
      *
+     * @param group     the {@link EventExecutorGroup} which will be used to execute the {@link ChannelHandler}
+     *                  methods
      * @param baseName  the name of the existing handler
      * @param name      the name of the handler to insert before
      * @param handler   the handler to insert before
@@ -317,6 +323,8 @@ public interface ChannelPipeline extends ChannelInboundInvoker, ChannelOutboundI
      * Inserts a {@link ChannelHandler} after an existing handler of this
      * pipeline.
      *
+     * @param group     the {@link EventExecutorGroup} which will be used to execute the {@link ChannelHandler}
+     *                  methods
      * @param baseName  the name of the existing handler
      * @param name      the name of the handler to insert after
      * @param handler   the handler to insert after
@@ -330,12 +338,40 @@ public interface ChannelPipeline extends ChannelInboundInvoker, ChannelOutboundI
      */
     ChannelPipeline addAfter(EventExecutorGroup group, String baseName, String name, ChannelHandler handler);
 
+    /**
+     * Inserts a {@link ChannelHandler}s at the first position of this pipeline.
+     *
+     * @param handlers  the handlers to insert first
+     *
+     */
     ChannelPipeline addFirst(ChannelHandler... handlers);
 
+    /**
+     * Inserts a {@link ChannelHandler}s at the first position of this pipeline.
+     *
+     * @param group     the {@link EventExecutorGroup} which will be used to execute the {@link ChannelHandler}s
+     *                  methods.
+     * @param handlers  the handlers to insert first
+     *
+     */
     ChannelPipeline addFirst(EventExecutorGroup group, ChannelHandler... handlers);
 
+    /**
+     * Inserts a {@link ChannelHandler}s at the last position of this pipeline.
+     *
+     * @param handlers  the handlers to insert last
+     *
+     */
     ChannelPipeline addLast(ChannelHandler... handlers);
 
+    /**
+     * Inserts a {@link ChannelHandler}s at the last position of this pipeline.
+     *
+     * @param group     the {@link EventExecutorGroup} which will be used to execute the {@link ChannelHandler}s
+     *                  methods.
+     * @param handlers  the handlers to insert last
+     *
+     */
     ChannelPipeline addLast(EventExecutorGroup group, ChannelHandler... handlers);
 
     /**