diff --git a/distributed/distributed-schema.yaml b/distributed/distributed-schema.yaml
index 8d73b7df145..ce43bcd4a06 100644
--- a/distributed/distributed-schema.yaml
+++ b/distributed/distributed-schema.yaml
@@ -754,8 +754,14 @@ properties:
             properties:
               connect:
                 type: string
+                description: |
+                  Timeout after which to error when estabilishing a connection.
+                  For example, when creating a connection between client and worker,
+                  client and scheduler, etc.
               tcp:
                 type: string
+                description: |
+                  Timeout after which to error when creating a TCP/Socket connection
 
           require-encryption:
             type: