Update cdu and user16 documentation (#628)

* Add alternative cdu column

* Additional documentation

* Sort column names

* Fix shared column name

* Update cdu documentation

dbt/models/iasworld/schema/iasworld.comdat.yml

@@ -396,6 +396,8 @@ sources:
             description: Number of units
           - name: upd_status
             description: '{{ doc("column_upd_status") }}'
+          - name: user16
+            description: '{{ doc("shared_column_alternative_cdu") }}'
           - name: useradj
             description: Override to comdat userdef adjustment factor
           - name: valmeth

dbt/models/iasworld/schema/iasworld.dweldat.yml

@@ -1396,6 +1396,8 @@ sources:
                   config: *unique-conditions
                   meta:
                     description: user15 (Use) should not be null
+          - name: user16
+            description: '{{ doc("shared_column_alternative_cdu") }}'
           - name: user17
             description: Age. Deprecated, use `yrblt`
           - name: user20

dbt/models/iasworld/schema/iasworld.oby.yml

@@ -449,7 +449,7 @@ sources:
           - name: upd_status
             description: '{{ doc("column_upd_status") }}'
           - name: user16
-            description: '{{ doc("shared_column_cdu") }}'
+            description: '{{ doc("shared_column_alternative_cdu") }}'
           - name: valmeth
             description: Valuation Method (R(CLT/RES) or M(MSB))
           - name: vect

dbt/models/shared_columns.md

@@ -186,6 +186,17 @@ Reason for change or no change
 
 # Assessed / Market Values
 
+## alternative_cdu
+
+{% docs shared_column_alternative_cdu %}
+Condition/Desirability/Utility code.
+
+Code representing any number of seemingly unrelated characteristics
+associated with a PIN, ranging from condition to types of subsidies, to
+whether or not a PIN is a garage. The full list of CDU codes can be found in
+`ccao.cdu`. For "condition", see the `cdu` column.
+{% enddocs %}
+
 ## board_bldg
 
 {% docs shared_column_board_bldg %}
@@ -852,10 +863,8 @@ Equivalent to legacy `MLT_CD` (multicode) value
 {% docs shared_column_cdu %}
 Condition/Desirability/Utility code.
 
-Code representing any number of seemingly unrelated characteristics
-associated with a PIN, ranging from condition to types of subsidies, to
-whether or not a PIN is a garage. The full list of CDU codes can be found on
-the Assessor's site
+The `cdu` column only documents "condition". See `user16` for what the
+Assessor's office typically considers the Condition/Desirability/Utility code.
 {% enddocs %}
 
 ## class