From 9d89216ca4edef1be2a46ab8e50d0668c91fc015 Mon Sep 17 00:00:00 2001 From: Johannes Marbach Date: Mon, 10 Jun 2024 11:31:58 +0200 Subject: [PATCH] Clarify that relations recursion should be capped at a certain depth Signed-off-by: Johannes Marbach --- data/api/client-server/relations.yaml | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) 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: