Skip to content

docs: document restricted diagram operations (new in 2.2)#155

Open
dimitri-yatsenko wants to merge 5 commits intodocs/v2.2-thread-safefrom
docs/v2.2-restricted-diagram
Open

docs: document restricted diagram operations (new in 2.2)#155
dimitri-yatsenko wants to merge 5 commits intodocs/v2.2-thread-safefrom
docs/v2.2-restricted-diagram

Conversation

@dimitri-yatsenko
Copy link
Member

Summary

  • Add Operational Methods section to diagram.md spec: cascade(), restrict(), delete(), drop(), preview(), restriction propagation rules, OR-vs-AND convergence
  • Add Graph-Driven Diagram Operations section to whats-new-22.md: motivation, preview-then-execute pattern, two propagation modes, architecture note
  • Add Diagram-Level Delete section to delete-data.md: build-preview-execute workflow, when to use
  • Add version admonition in data-manipulation.md noting graph-driven cascade internals
  • Cross-references between all four files

Test plan

  • mkdocs build succeeds with no new warnings
  • Review rendered pages for diagram.md, whats-new-22.md, delete-data.md, data-manipulation.md
  • Verify cross-reference links resolve correctly

🤖 Generated with Claude Code

dimitri-yatsenko and others added 5 commits February 22, 2026 11:53
Add documentation for cascade(), restrict(), delete(), drop(), and
preview() methods on dj.Diagram, including restriction propagation
rules and OR-vs-AND convergence semantics.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Specifies prune() as a method that removes tables with zero matching
rows from the diagram. Works with or without prior restrictions.
Primary use case is export workflows where you want to visualize
only the portion of the pipeline that has matching data.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ions

Add "Pruning Empty Tables" subsection to the graph-driven diagram
operations explanation. Add arXiv:2602.16585 to the 2026 publications list.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add prune() to the operation reference table and the summary
feature table in the read-diagrams notebook.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Merge latest publications from main (Cotton & Leonard, Donahue et al.,
Reimer et al., and 4 others) and re-add arXiv:2602.16585.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant