Skip to content

Commit 1bc28f5

Browse files
docs: clarify cascade/restrict wording — unaffected, not removed
Ancestors remain in the diagram but receive no restrictions and are unaffected by delete/preview. Previous wording ("excluded") was imprecise — they're not removed from the graph, just not operated on. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent af0c0db commit 1bc28f5

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

src/reference/specs/diagram.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ Diagrams can propagate restrictions through the dependency graph and execute dat
130130
diag.cascade(table_expr, part_integrity="enforce")
131131
```
132132

133-
Apply a cascade restriction and propagate it downstream through the dependency graph. Only the seed table and its descendants are affected — ancestors of the seed table are excluded. Uses **OR** semantics at convergence — a child row is affected if *any* restricted ancestor reaches it. Designed for delete operations.
133+
Apply a cascade restriction and propagate it downstream through the dependency graph. Only the seed table and its descendants receive restrictions — ancestors of the seed table are unaffected by subsequent `delete()` or `preview()` calls. Uses **OR** semantics at convergence — a child row is affected if *any* restricted ancestor reaches it. Designed for delete operations.
134134

135135
| Parameter | Type | Default | Description |
136136
|-----------|------|---------|-------------|
@@ -165,7 +165,7 @@ restricted = diag.cascade(Session & {'subject_id': 'M001'})
165165
diag.restrict(table_expr)
166166
```
167167

168-
Apply a restrict condition and propagate it downstream. Only the seed table and its descendants are affected — ancestors of the seed table are excluded. Uses **AND** semantics at convergence — a child row is included only if it satisfies *all* restricted ancestors. Designed for data subsetting and export operations.
168+
Apply a restrict condition and propagate it downstream. Only the seed table and its descendants receive restrictions — ancestors of the seed table are unaffected by subsequent operations. Uses **AND** semantics at convergence — a child row is included only if it satisfies *all* restricted ancestors. Designed for data subsetting and export operations.
169169

170170
| Parameter | Type | Default | Description |
171171
|-----------|------|---------|-------------|

0 commit comments

Comments
 (0)