Skip to main content

Documentation and Lineage for Analytics Engineers

Documentation and lineage in dbt means describing models and columns in YAML, generating a searchable docs site, and using the dependency graph to see where data comes from and what depends on it. Column-level lineage extends this to individual fields for impact analysis.

Stage: dbt in Depth · Part of the Analytics Engineer roadmap · Last reviewed 19 November 2026

What to learn in Documentation and Lineage

Documentation and Lineage interview questions

How does dbt generate lineage?

Each ref and source call in a model records a dependency. dbt assembles these into a directed acyclic graph that shows upstream and downstream relationships, and the docs site displays it for any model.

Why document columns and not only models?

Column descriptions explain meaning, units and edge cases that names cannot, which prevents misuse and repeated questions. Tests and descriptions together act as the contract between modellers and consumers.

Where Documentation and Lineage fits in the Analytics Engineer roadmap

Documentation and Lineage belongs to the dbt in Depth stage (intermediate level), which takes about 7 hours. The core craft.

Back to the full Analytics Engineer roadmap