Relationship model
StableThe core model
Cardinality
| Relationship | Cardinality | Notes |
|---|---|---|
| Chapter to question | many to many | A question can span chapters |
| Question to hypothesis | one to many | A hypothesis serves exactly one question |
| Hypothesis to project | many to many | A project may test several |
| Project to experiment | one to many | An experiment belongs to one project |
| Experiment to dataset | many to many | Datasets are shared |
| Experiment to result | one to many | |
| Result to figure | one to many | |
| Publication to anything | many to many | A paper draws on whatever it draws on |
Direction
Links are recorded downward in registry/relationships.yaml: a project
lists its experiments, not the other way round. Upward links on pages are
convenience, derived from the same source.
Recording both directions by hand is how they come to disagree, and when they disagree there is no way to tell which one is right.
Literature is special
Literature informs entities but is never part of the evidence chain. A claim supported only by a citation is a claim inherited from someone else’s work, and must be labelled as such rather than presented as a result of this research.
Validation
pnpm validate checks that every identifier mentioned in a relationship exists,
that hypotheses have exactly one parent question, and that no relationship
points at an entity of the wrong type.
Last updated on