From 079be0a1a799967080bc18ceb3d57cab2cfc1af4 Mon Sep 17 00:00:00 2001
From: Ryan Hughes <ryan@heyoodle.com>
Date: Sat, 16 May 2026 00:37:12 -0400
Subject: [PATCH] Slim down comments in shell.toml.tpl

Keep only the non-obvious bits: the override mechanism, what counts as
"active" on the bar, the flyout text-color constraint, the
notifications-border convention, and the image-picker alpha modulation.
Drop comments that just restated the key names.
---
 default/themed/shell.toml.tpl | 32 ++++++++------------------------
 1 file changed, 8 insertions(+), 24 deletions(-)

diff --git a/default/themed/shell.toml.tpl b/default/themed/shell.toml.tpl
index 63f23143..10ea286a 100644
--- a/default/themed/shell.toml.tpl
+++ b/default/themed/shell.toml.tpl
@@ -1,50 +1,34 @@
-# Omarchy shell colors. Defaults below derive from colors.toml. Any theme
-# can ship its own shell.toml at themes/<name>/shell.toml to override
-# individual keys — anything left out falls back to the values here.
+# Omarchy shell colors. Defaults derive from colors.toml; themes can ship
+# themes/<name>/shell.toml to override individual keys.
 
 [bar]
-# The bar strip itself
 background = "{{ background }}"
-# Clock, weather, workspace numbers, indicator glyphs
 text       = "{{ foreground }}"
-# Module in an "active" state: screen recording, voxtype listening,
-# weather alert, update available. Same color is used everywhere a
-# module wants to call attention to itself.
+# Modules calling attention to themselves (recording, voxtype, alerts, updates)
 active     = "{{ color1 }}"
 
 [popups]
-# Body fill for every flyout opened from the bar: wifi, bluetooth, audio,
-# calendar, weather, control-center, notification-center, media. Body text
-# inside the flyouts is not separately themable — it follows [bar].text.
+# Shared by every bar flyout. Body text inside flyouts is not separately
+# themable — it follows [bar].text.
 background = "{{ background }}"
-# 1px outline around the flyout
 border     = "{{ foreground }}"
 
 [notifications]
-# Toast card body
 background = "{{ background }}"
-# Title and message text
 text       = "{{ foreground }}"
-# Card outline. Most themes match this to their Hyprland active-window
-# border so notifications visually belong to the focused window.
+# Conventionally matches the Hyprland active-window border
 border     = "{{ accent }}"
-# Bottom countdown bar that drains while the toast is on screen
 countdown  = "{{ accent }}"
 
 [menu]
-# Omarchy menu surface (the launcher-style picker invoked by the menu key)
 background = "{{ background }}"
-# Unhighlighted menu items
 text       = "{{ foreground }}"
-# Currently hovered / keyboard-selected item
 selected   = "{{ accent }}"
 
 [image-picker]
-# Backdrop scrim behind the picker (the picker draws this at ~70% alpha)
+# Drawn at ~70% alpha as a scrim
 background        = "{{ background }}"
-# Tile labels (image filename / theme name)
 text              = "{{ foreground }}"
-# 3px stroke around the currently selected tile
 selected-border   = "{{ accent }}"
-# 1px stroke around every other tile (picker applies ~28% alpha)
+# Drawn at ~28% alpha
 unselected-border = "{{ foreground }}"