Skip to content

Conversation

@dimitri-yatsenko
Copy link
Member

No description provided.

claude and others added 6 commits December 13, 2025 03:17
Add new introductory chapter (000-introduction.md) that:
- Defines operations in the context of the Relational Workflow Model
- Distinguishes manual operations (insert, delete, update) from automatic (populate)
- Clarifies that Lookup tables are part of schema definition, not workflow
- Explains the workflow execution pattern

Update existing chapters for narrative consistency:
- Insert: Connect to workflow model, clarify Lookup vs Manual usage
- Delete: Emphasize cascading delete for computational validity
- Updates: Strengthen explanation of why updates are rare
- Populate: Reference new introduction and other chapters
Update Operations introduction and Insert chapter to clarify that:
- "Manual" means data originates outside the pipeline, not human-initiated
- Scripts, external systems, and automated imports are manual operations
- The key distinction is external origin vs. pipeline-driven populate()
…-section-01DZM7WBqMKF7bBEGmCJSGVK

Revise Operations section for relational workflow
Lookup tables are populated via the `contents` property in the table
definition, not through insert commands. An "empty" pipeline has its
lookup tables automatically populated when the schema is activated.

Updated:
- Workflow Operations: Show contents property for Lookup tables
- Insert chapter: Remove Lookup table references, focus on Manual tables
- Populate chapter: Correct table showing data entry methods
…-section-01DZM7WBqMKF7bBEGmCJSGVK

Correct Lookup table population: use contents property, not insert
@dimitri-yatsenko dimitri-yatsenko merged commit bd53c48 into datajoint:main Dec 13, 2025
1 check passed
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.

2 participants