diff --git a/data/api/client-server/relations.yaml b/data/api/client-server/relations.yaml
index b033e88f..e4eca96d 100644
--- a/data/api/client-server/relations.yaml
+++ b/data/api/client-server/relations.yaml
@@ -315,11 +315,10 @@ components:
         If set to `false`, only events which have direct a relation with the given
         event will be included.
 
-        If set to `true`, all events which relate to the given event, or relate to
-        events that relate to the given event, will be included.
-
-        It is recommended that homeservers traverse at least 3 levels of relationships.
-        Implementations may perform more but should be careful to not infinitely recurse.
+        If set to `true`, events which have an indirect relation with the given event
+        will be included additionally up to a certain depth level. Homeservers SHOULD traverse
+        at least 3 levels of relationships. Implementations MAY perform more but MUST be careful
+        to not infinitely recurse.
 
         The default value is `false`.
       schema: