Document source models and sources.

brooklyn-data · Nov 30, 2021 · 3834d3b · 3834d3b
1 parent 98f7326
commit 3834d3b
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/dbt_coding_conventions.md b/dbt_coding_conventions.md
@@ -305,6 +305,8 @@ Sources have some nice features:
   - Testing source columns.
   - Calculating the freshness of source data.
 
+Sources should have the `description` and `loader` properties completed to give context on the source to future developers.
+
 <br>
 
 ## Models
@@ -449,6 +451,8 @@ Having a separate schema `.yml` file for each model has several benefits:
   - Clearly shows which models have documentation/tests and which don't.
   - Helps avoid version control merge conflicts.
 
+Final models and source models should be documented. Intermediate models do not require documentation.
+
 <br>
 
 #### A model is not complete without tests and documentation.