diff --git a/matrix/synapse/workers.md b/matrix/synapse/workers.md
index 9ac37c5..c84eec7 100644
--- a/matrix/synapse/workers.md
+++ b/matrix/synapse/workers.md
@@ -82,8 +82,7 @@ entries like this:
 
 ```
 synapse.replication.tcp.redis - 292 - INFO - sentinel - Connecting to redis server UNIXAddress('/run/redis/redis-server.sock')
-synapse.util.httpresourcetree - 56 - INFO - sentinel - Attaching <synapse.replication.http.ReplicationRestResource object at 0x7f95f850d15
-0> to path b'/_synapse/replication'
+synapse.util.httpresourcetree - 56 - INFO - sentinel - Attaching <synapse.replication.http.ReplicationRestResource object at 0x7f95f850d150> to path b'/_synapse/replication'
 synapse.replication.tcp.redis - 126 - INFO - sentinel - Connected to redis
 synapse.replication.tcp.redis - 138 - INFO - subscribe-replication-0 - Sending redis SUBSCRIBE for ['matrix.example.com/USER_IP', 'matrix.example.com']
 synapse.replication.tcp.redis - 141 - INFO - subscribe-replication-0 - Successfully subscribed to redis stream, sending REPLICATE command
@@ -91,3 +90,10 @@ synapse.replication.tcp.redis - 146 - INFO - subscribe-replication-0 - REPLICATE
 ```
 
 
+# Workers
+
+Workers are Synapse instances that perform a single job (or a set of jobs).
+Their configuration goes into `/etc/matrix-synapse/workers`, which we have to
+create first.
+
+