Missing References: Broken Cross-References and Phantom Sections

"See Appendix C for the full methodology." If there is no Appendix C, that sentence is not just wrong — it creates doubt about everything around it.

What is a missing reference?

A missing reference occurs when a document points to something that does not exist within it. The categories include:

**Missing appendices and annexes.** The body text refers to an appendix that was planned but never written, or that was removed during editing without updating the references to it.

**Broken section cross-references.** "As discussed in Section 4.2" when Section 4.2 does not exist, or when the section was renumbered and the reference was not updated.

**Phantom figures and tables.** "See Figure 3" in a document where Figure 3 was deleted or where the figures were renumbered starting from a different point.

**Undefined terms.** A term is used as though it has been defined — often in quotation marks or with an initial capital letter — but the definition clause does not include it.

**External documents that were not attached.** "As per the attached schedule" when no schedule is attached.

Why cross-references break

Cross-references break because documents are living objects. They are created, edited, restructured, and reviewed by multiple people over time. A section that exists when a reference to it is written may be removed, merged with another section, or renumbered in a later revision.

Automated heading numbering in word processors helps but does not solve the problem. If a section title changes, a cross-reference by title rather than by number becomes stale. If a section is deleted and its number is not reused, any reference to it silently breaks.

The cost of broken references

In legal documents, a reference to a non-existent appendix may be evidence that the agreement is incomplete. If the appendix was supposed to contain material terms — a price schedule, a specification, a list of covered items — its absence makes those terms uncertain.

In technical documentation, a reference to a non-existent section leaves the reader without the information they were directed to. If the document is a maintenance manual or a safety procedure, the consequence can be serious.

In reports and proposals, broken references suggest poor quality control. A reader who finds one broken reference will distrust the document more broadly.

Detection

Automated detection works by extracting all reference expressions — "Section X," "Appendix Y," "Figure Z," "Table N," defined term usage — and checking whether each one resolves to something that exists in the document.

For numeric references, this is straightforward: the system checks whether a section, figure, or appendix with that number exists. For defined terms, the system checks whether the term appears in a definitions clause.

The result is a list of references that cannot be resolved, each with its location in the document.

Fixing broken references

For each broken reference, the resolution is one of three things: find the correct target and update the reference, create the missing content if it was genuinely omitted, or remove the reference if it is no longer needed.

The most important fix is structural: after any significant reorganisation of a document, run a reference check before distribution. Renumbering sections, removing appendices, or restructuring the table of contents should always be followed by a pass to verify that all internal references still resolve.

A note on external references

The same problem applies to external documents. A contract that incorporates a policy "by reference" without attaching a copy of that policy creates ambiguity about what version applies and whether the counterparty has had access to it. Wherever possible, referenced external documents should be attached, quoted, or specifically identified by version number and date.