From efd4efa86285b33e6d0700b86758a3906e891ebf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc-Andr=C3=A9=20Bombeck?= Date: Thu, 10 Sep 2026 11:52:54 +0200 Subject: [PATCH] docs(sharing): stop the cross-section predicate's docblock from listing its callers It named three of them and the booster mint made four the same day. A comment that enumerates its own callers goes stale on the next one, so it states the shape instead and keeps the note about the two verbatim copies it replaced. --- src/lib/sharing/acting-domains.ts | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/src/lib/sharing/acting-domains.ts b/src/lib/sharing/acting-domains.ts index c8bb830d5..039062bc2 100644 --- a/src/lib/sharing/acting-domains.ts +++ b/src/lib/sharing/acting-domains.ts @@ -1,12 +1,13 @@ /** * Which sections of the record the caller is actually inside. * - * Lives here rather than beside one feature because three unrelated seams ask - * it — a visit's link labels, a vaccination's, and the cycle crosstab's - * outcome columns — and a route that reads across its own declared section is - * a shape the product will keep growing. Two verbatim copies of it already - * existed in the visits and vaccination services; a third would have been the - * one that drifted. + * Lives here rather than beside one feature because a route that reads or + * writes across its own declared section is a shape the product keeps growing, + * and its callers are already spread over four features. No list of them here: + * a comment that enumerates its own callers is a comment that goes stale on + * the next one. Two verbatim copies of this existed in the visits and the + * vaccination service, with a note on the second saying a second spelling + * would be a second thing to keep in step. * * Returns a predicate rather than a set so the owner path costs nothing: with * no grant there is nothing to look up and every domain is open. A grant that