diff --git a/styles/src/theme/color_scheme.ts b/styles/src/theme/color_scheme.ts
index 933c6160535386dea3f7b3b517c3d95b234cbcbe..c64be951841dac22b5d3b984ee0abea5876a584b 100644
--- a/styles/src/theme/color_scheme.ts
+++ b/styles/src/theme/color_scheme.ts
@@ -12,8 +12,17 @@ export interface ColorScheme {
     name: string
     is_light: boolean
 
+    /**
+    * App background, other elements that should sit directly on top of the background.
+    */
     lowest: Layer
+    /**
+    * Panels, tabs, other UI surfaces that sit on top of the background.
+    */
     middle: Layer
+    /**
+    * Editors like code buffers, conversation editors, etc.
+    */
     highest: Layer
 
     ramps: RampSet