From cdae7db4c483df5a3c447c58da19c507a0648bd4 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Wed, 19 Nov 2025 12:40:59 +0100 Subject: [PATCH 1/4] Add Depth of Retrieval Clause --- md/clause-7.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/md/clause-7.md b/md/clause-7.md index 901fa73..f1f8402 100644 --- a/md/clause-7.md +++ b/md/clause-7.md @@ -1992,6 +1992,19 @@ Broker]{.HTML-Keyboard}. An example of this representation can be found in annex C, clause C.2.2.1.3. +### 7.7.4 Depth of retrieval + +When retrieving [Linked Entities]{.HTML-Keyboard}, the [Linking +Entity]{.HTML-Keyboard} may have a _Relationships_ to [Linked +Entities]{.HTML-Keyboard} which may in turn have a _Relationships_, to further +[Linked Entities]{.HTML-Keyboard}. Complete traversal of a densely or +recursively linked Entity graph would result in payloads of an excessive length. +Therefore to mitigate this, the default depth of retrieval (or _`joinLevel_) +shall be set to one, though this may be overridden on request. Furthermore, +whenever a [Linked Entity]{.HTML-Keyboard} has already been encountered during +graph traversal, its [Linked Entities]{.HTML-Keyboard} shall not undergo further +expansion. + ## 7.8 Tenants #### 7.8.1 Introduction -- GitLab From cdaa3166999f9d624cdd19af30e9c8402f90dd46 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Wed, 19 Nov 2025 13:17:49 +0100 Subject: [PATCH 2/4] Correct text --- md/clause-7.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/md/clause-7.md b/md/clause-7.md index f1f8402..7722572 100644 --- a/md/clause-7.md +++ b/md/clause-7.md @@ -1999,7 +1999,7 @@ Entity]{.HTML-Keyboard} may have a _Relationships_ to [Linked Entities]{.HTML-Keyboard} which may in turn have a _Relationships_, to further [Linked Entities]{.HTML-Keyboard}. Complete traversal of a densely or recursively linked Entity graph would result in payloads of an excessive length. -Therefore to mitigate this, the default depth of retrieval (or _`joinLevel_) +Therefore to mitigate this, the default depth of retrieval (or _`joinLevel`_) shall be set to one, though this may be overridden on request. Furthermore, whenever a [Linked Entity]{.HTML-Keyboard} has already been encountered during graph traversal, its [Linked Entities]{.HTML-Keyboard} shall not undergo further -- GitLab From 654754b5a6b625d8000d777fcbc4694156af912f Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Mon, 24 Nov 2025 12:15:25 +0100 Subject: [PATCH 3/4] Tweak text - explain shallower depth --- md/clause-7.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/md/clause-7.md b/md/clause-7.md index 7722572..2b05ea0 100644 --- a/md/clause-7.md +++ b/md/clause-7.md @@ -1995,15 +1995,15 @@ An example of this representation can be found in annex C, clause C.2.2.1.3. ### 7.7.4 Depth of retrieval When retrieving [Linked Entities]{.HTML-Keyboard}, the [Linking -Entity]{.HTML-Keyboard} may have a _Relationships_ to [Linked -Entities]{.HTML-Keyboard} which may in turn have a _Relationships_, to further -[Linked Entities]{.HTML-Keyboard}. Complete traversal of a densely or -recursively linked Entity graph would result in payloads of an excessive length. -Therefore to mitigate this, the default depth of retrieval (or _`joinLevel`_) -shall be set to one, though this may be overridden on request. Furthermore, -whenever a [Linked Entity]{.HTML-Keyboard} has already been encountered during -graph traversal, its [Linked Entities]{.HTML-Keyboard} shall not undergo further -expansion. +Entity]{.HTML-Keyboard} may contain _Relationships_ to [Linked +Entities]{.HTML-Keyboard} which in turn may contain _Relationships_, to further +[Linked Entities]{.HTML-Keyboard}. Complete traversal of a chain of linked +Entities could result in payloads of an excessive length. Therefore to mitigate +this, the default depth of retrieval (or _`joinLevel`_) shall be set to one, +though this may be overridden on request. Furthermore, to avoid unnecessary +duplication, whenever a [Linked Entity]{.HTML-Keyboard} has already been +previously encountered during graph traversal at a shallower depth, its [Linked +Entities]{.HTML-Keyboard} shall not undergo further expansion for a second time. ## 7.8 Tenants -- GitLab From e8b706d414dfc846ff834f54c36dd720e03551fe Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 2 Dec 2025 11:22:08 +0100 Subject: [PATCH 4/4] Amend text --- md/clause-7.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/md/clause-7.md b/md/clause-7.md index 2b05ea0..ce59764 100644 --- a/md/clause-7.md +++ b/md/clause-7.md @@ -2000,10 +2000,11 @@ Entities]{.HTML-Keyboard} which in turn may contain _Relationships_, to further [Linked Entities]{.HTML-Keyboard}. Complete traversal of a chain of linked Entities could result in payloads of an excessive length. Therefore to mitigate this, the default depth of retrieval (or _`joinLevel`_) shall be set to one, -though this may be overridden on request. Furthermore, to avoid unnecessary -duplication, whenever a [Linked Entity]{.HTML-Keyboard} has already been -previously encountered during graph traversal at a shallower depth, its [Linked -Entities]{.HTML-Keyboard} shall not undergo further expansion for a second time. +meaning that only one level of _Relationships_ are traversed, though this may be +overridden on request. Furthermore, to avoid unnecessary duplication, whenever a +[Linked Entity]{.HTML-Keyboard} has already been previously encountered during graph +traversal at a shallower depth, its [Linked Entities]{.HTML-Keyboard} shall not undergo +further expansion for a second time. ## 7.8 Tenants -- GitLab