diff --git a/docs/workers.rst b/docs/workers.rst
index b687807e59..dee04bbf3e 100644
--- a/docs/workers.rst
+++ b/docs/workers.rst
@@ -50,7 +50,7 @@ the public internet; it currently implements no authentication whatsoever and is
 unencrypted.
 
 (Roughly, the TCP port is used for streaming data from the master to the
-workers, and the HTTP port for the workers to communicate with the main
+workers, and the HTTP port for the workers to send data to the main
 synapse process.)
 
 You then create a set of configs for the various worker processes.  These
@@ -69,6 +69,9 @@ replication endpoints that it's talking to on the main synapse process.
 ``worker_replication_port`` should point to the TCP replication listener port and
 ``worker_replication_http_port`` should point to the HTTP replication port.
 
+Currently, only the ``event_creator`` worker requires specifying
+``worker_replication_http_port``.
+
 For instance::
 
     worker_app: synapse.app.synchrotron