start adding specific descriptions to each color theme color

schemas/color-theme/v1.json

@@ -12,13 +12,16 @@
       "description": "Contains the values that will be used to populate the CSS variables controlling the UI theme",
       "properties": {
         "sun": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The color of the sun icon used to indicate that the light color theme is active"
         },
         "moon": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The color of the moon icon used to indicate that the dark color theme is active"
         },
         "bg_main": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The primary background color applied to the page as a whole"
         },
         "bg_light": {
           "$ref": "#/definitions/css_color"
@@ -33,22 +36,27 @@
           "$ref": "#/definitions/css_color"
         },
         "text_heading": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The color of heading text"
         },
         "text_body": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The color of main / normal body copy text"
         },
         "text_light": {
           "$ref": "#/definitions/css_color"
         },
         "text_link": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The default color of hyperlinks"
         },
         "text_link_active": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The color of hyperlinks that are currently active / selected"
         },
         "text_link_visited": {
-          "$ref": "#/definitions/css_color"
+          "$ref": "#/definitions/css_color",
+          "description": "The color of hyperlinks that have been previously visited"
         },
         "text_highlight": {
           "$ref": "#/definitions/css_color"
@@ -220,7 +228,6 @@
   },
   "definitions": {
     "css_color": {
-      "description": "A valid CSS color value;\nSee https://developer.mozilla.org/en-US/docs/Web/CSS/color_value\n",
       "oneOf": [
         {
           "type": "string",

schemas/color-theme/v1.yaml

@@ -13,40 +13,61 @@ properties:
     description: Contains the values that will be used to populate the CSS variables
       controlling the UI theme
     properties:
+      # Theme Picker Icon Colors
       sun:
         $ref: "#/definitions/css_color"
+        description: The color of the sun icon used to indicate that the light color theme is active
       moon:
         $ref: "#/definitions/css_color"
+        description: The color of the moon icon used to indicate that the dark color theme is active
+
+      # Content Background Colors
       bg_main:
         $ref: "#/definitions/css_color"
+        description: The primary background color applied to the page as a whole
       bg_light:
         $ref: "#/definitions/css_color"
       bg_heavy:
         $ref: "#/definitions/css_color"
       bg_popup_mask:
         $ref: "#/definitions/css_color"
+
+      # 
       line:
         $ref: "#/definitions/css_color"
+
+      # Main Content Text Colors
       text_heading:
         $ref: "#/definitions/css_color"
+        description: The color of heading text
       text_body:
         $ref: "#/definitions/css_color"
+        description: The color of main / normal body copy text
       text_light:
         $ref: "#/definitions/css_color"
       text_link:
         $ref: "#/definitions/css_color"
+        description: The default color of hyperlinks
       text_link_active:
         $ref: "#/definitions/css_color"
+        description: The color of hyperlinks that are currently active / selected
       text_link_visited:
         $ref: "#/definitions/css_color"
+        description: The color of hyperlinks that have been previously visited
+
+      # Text Highlighted with <mark>
       text_highlight:
         $ref: "#/definitions/css_color"
       bg_text_highlight:
         $ref: "#/definitions/css_color"
+
+      # User-Selected Text
       text_selection:
         $ref: "#/definitions/css_color"
       bg_text_selection:
         $ref: "#/definitions/css_color"
+
+      # Buttons
       bg_button_primary:
         $ref: "#/definitions/css_color"
       bg_button_primary_hover:
@@ -59,18 +80,24 @@ properties:
         $ref: "#/definitions/css_color"
       text_button_secondary:
         $ref: "#/definitions/css_color"
+
+      # Error Boxes / Alerts
       bg_error_box:
         $ref: "#/definitions/css_color"
       border_error_box:
         $ref: "#/definitions/css_color"
       text_error_box:
         $ref: "#/definitions/css_color"
+
+      # Inputs / Forms
       bg_input:
         $ref: "#/definitions/css_color"
       border_input:
         $ref: "#/definitions/css_color"
       border_input_invalid:
         $ref: "#/definitions/css_color"
+
+      # Activity / Result Indicators
       icon_active_indicator:
         $ref: "#/definitions/css_color"
       icon_success_indicator:
@@ -79,6 +106,8 @@ properties:
         $ref: "#/definitions/css_color"
       icon_warning_indicator:
         $ref: "#/definitions/css_color"
+
+      # Charts
       chart_axis:
         $ref: "#/definitions/css_color"
       chart_text:
@@ -105,6 +134,8 @@ properties:
         $ref: "#/definitions/css_color"
       chart_data_9:
         $ref: "#/definitions/css_color"
+
+      # Pre-Formatted / Syntax Highlighted Code Blocks
       code_normal:
         $ref: "#/definitions/css_color"
       code_shadow:
@@ -151,9 +182,6 @@ properties:
         $ref: "#/definitions/css_color"
 definitions:
   css_color:
-    description: |
-      A valid CSS color value;
-      See https://developer.mozilla.org/en-US/docs/Web/CSS/color_value
     oneOf:
       # Hex Colors
       - type: string