Clarify how colors work (#1015)

* explain how colors are used

* simplify colors section

Author: ethanpalm

settings.mdx

@@ -52,28 +52,21 @@ See [Themes](themes) for more information.
 </ResponseField>
 
 <ResponseField name="colors" type="object" required>
-  The colors to use in your documentation. A primary color is required. For example:
-  ```json
-  {
-    "colors": {
-      "primary": "#ff0000"
-    }
-  }
-  ```
+  The colors used in your documentation. Colors are applied differently across themes. If you only provide a primary color, it will be used for all color elements.
 
   <Expandable title="Colors">
     <ResponseField name="primary" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" required>
-      The primary color of your theme.
+      The primary color for your documentation. Generally used for emphasis in light mode, with some variation by theme.
 
       Must be a hex code beginning with `#`.
     </ResponseField>
     <ResponseField name="light" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
-      Light color variant of your theme.
+      The color used for emphasis in dark mode.
 
       Must be a hex code beginning with `#`.
     </ResponseField>
     <ResponseField name="dark" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
-      Dark color variant of your theme.
+      The color used for buttons and hover states across both light and dark modes, with some variation by theme.
 
       Must be a hex code beginning with `#`.
     </ResponseField>