Why Link Documents?
Document links are what turn a pile of documents into a governance graph: Policy → SOP → Work Instruction → Training. When any document in the graph is published, BFF’s Change Impact Analysis walks the links in both directions and alerts the owner of every connected document — so a policy change can’t silently leave a downstream work instruction out of date.
A document with no links is invisible to impact analysis. The Links panel says it plainly: “No links yet — this document is isolated from the impact graph.”
Adding a Link
-
Open any document’s detail page
-
Click “Links” (visible to admins and the document Owner)
-
Choose a Relationship:
Relationship Use when… Implements This document puts a higher-tier document into practice (an SOP implements a Policy) References This document cites or depends on another Trains on A Training document teaches another document’s content Supersedes This document replaces an older one -
Pick the target Document — the picker is grouped by tier, and any tier can link to any tier
-
Click “Link”
Reading the Links Panel
Each link row shows its direction — an outgoing arrow for links from this document (e.g., “Implements”) and an incoming arrow for links to it (e.g., “Implements this”) — plus the relationship, the linked document’s tier, and its title. Remove a link with the trash icon.
Links Drive Change Control
When a linked document is published:
- The owner of each connected document gets an Impact Cascade Alert (see the Impact Cascade Engine section), with an AI-generated explanation of what changed and why it matters
- Human assignees of tasks linked to affected documents get a Document Changed notification
- Readers whose acknowledgements went stale get Re-ack Required
- AI agents working from the document are notified via webhook
Document Links vs. Task Links
These are two different things:
- Document ↔ document links (this article) build the governance graph and are managed via the “Links” button
- Task ↔ document links attach governing documents to a task via the task’s “Link Content” picker, with one optional primary document
Both feed Change Impact Analysis, but only document links carry relationship types.
Tip: A good smoke test for your graph: open your most important Policy and check its links. If publishing it tomorrow wouldn’t alert anyone, the chain between your rules and your daily work is broken.