Las descripciones explican el significado de los datos en su nivel de detalle declarado. Una descripción útil nombra la entidad, la regla de inclusión y una limitación relevante. Las de columna aclaran identificadores y medidas.
Un bloque docs guarda Markdown más largo que puedes referenciar con doc sin repetir definiciones. La documentación pertenece junto al código para actualizar ambos a la vez.
Una exposición registra un uso posterior, como un panel, con responsable y dependencias. Añade contexto al linaje aunque dbt no construya el panel. Generar documentación reúne metadatos, pero no hace cierta una descripción engañosa.
Añade significado y responsabilidad a un modelo limpio. Usa direcciones ficticias example.test para responsables y no guardes secretos operativos en la documentación.
Un patrón resuelto con registros ficticios. Adapta el nombre del modelo y la regla de negocio a cada tarea.