diff --git a/bramble-api/src/main/java/org/briarproject/bramble/api/plugin/ConnectionHandler.java b/bramble-api/src/main/java/org/briarproject/bramble/api/plugin/ConnectionHandler.java
index 7255d03a1..17e7d0f59 100644
--- a/bramble-api/src/main/java/org/briarproject/bramble/api/plugin/ConnectionHandler.java
+++ b/bramble-api/src/main/java/org/briarproject/bramble/api/plugin/ConnectionHandler.java
@@ -1,7 +1,9 @@
 package org.briarproject.bramble.api.plugin;
 
 import org.briarproject.bramble.api.nullsafety.NotNullByDefault;
+import org.briarproject.bramble.api.plugin.duplex.DuplexPlugin;
 import org.briarproject.bramble.api.plugin.duplex.DuplexTransportConnection;
+import org.briarproject.bramble.api.plugin.simplex.SimplexPlugin;
 
 /**
  * An interface for handling connections created by transport plugins.
@@ -9,9 +11,18 @@ import org.briarproject.bramble.api.plugin.duplex.DuplexTransportConnection;
 @NotNullByDefault
 public interface ConnectionHandler {
 
+	/**
+	 * Handles a connection created by a {@link DuplexPlugin}.
+	 */
 	void handleConnection(DuplexTransportConnection c);
 
+	/**
+	 * Handles a reader created by a {@link SimplexPlugin}.
+	 */
 	void handleReader(TransportConnectionReader r);
 
+	/**
+	 * Handles a writer created by a {@link SimplexPlugin}.
+	 */
 	void handleWriter(TransportConnectionWriter w);
 }