Question
Why does containment reference fail?
Quick Answer
Containing everything produces bloated, unmaintainable artifacts — the 200-page requirements document nobody reads because updating one section means re-reviewing the whole thing. Referencing everything produces hollow shells — the project plan that's nothing but links, requiring six clicks to.
The most common reason containment reference fails: Containing everything produces bloated, unmaintainable artifacts — the 200-page requirements document nobody reads because updating one section means re-reviewing the whole thing. Referencing everything produces hollow shells — the project plan that's nothing but links, requiring six clicks to understand a single decision. Both failures come from applying one strategy uniformly instead of choosing deliberately at each node.
The fix: Open a current project document or note. Identify three pieces of information that are contained (they live inside this artifact and nowhere else) and three that are referenced (they point to something that exists independently). For each contained item, ask: should this actually be a reference to a shared source? For each reference, ask: is the linked content critical enough that I should contain a summary here? Make one change in each direction.
The underlying principle is straightforward: An item can be contained within a hierarchy level or merely referenced from it.
Learn more in these lessons