Using dbt doc blocks enables DRY (Don’t Repeat Yourself) documentation by defining field descriptions in central Markdown files, improving consistency and maintainability as projects scale. This approach prevents the need to redefine fields in multiple YAML files, allowing updates to be reflected instantly across all downstream models. The Hidden Cost of Poor Documentation Documentation is often one of the most overlooked aspects of data work. We build pipelines, structure our models, and deliver dashboards. The people already involved understand what is happening, but what happens when someone new joins?Without clear documentation, it becomes difficult for them to make sense of anything.With the rise of AI, this problem is only amplified. We increasingly expect to “talk” to our data, but if that data lacks clear definitions,