diff --git a/apps/web/android/app/src/main/res/values-night/colors.xml b/apps/web/android/app/src/main/res/values-night/colors.xml
index 0afb0d0..5b40f54 100644
--- a/apps/web/android/app/src/main/res/values-night/colors.xml
+++ b/apps/web/android/app/src/main/res/values-night/colors.xml
@@ -1,30 +1,30 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
   Dark-mode overrides for the native colour resources in
-  ../values/colors.xml. Without this file, `AppTheme.NoActionBar`'s
-  `DayNight` parent still resolved `@color/colorPrimaryDark` /
-  `@color/colorBackground` to their light values under a dark system
-  setting: the status-bar band and the pre-WebView window (cold-start
-  flash + splash ground) stayed on the light "porcelaine" palette while
-  the rest of the phone — and the app's own WebView content — went dark
-  (issue #104).
+  ../values/colors.xml. Without this file, AppTheme.NoActionBar's DayNight
+  parent still resolved @color/colorPrimaryDark / @color/colorBackground to
+  their light values under a dark system setting: the status-bar band and
+  the pre-WebView window (cold-start flash + splash ground) stayed on the
+  light "porcelaine" palette while the rest of the phone, and the app's own
+  WebView content, went dark (issue #104).
 
   Keep the hex values in sync with the dark-mode colour tokens in
-  apps/web/src/styles/_theme.scss (the `@media (prefers-color-scheme: dark)`
-  block).
+  apps/web/src/styles/_theme.scss (the prefers-color-scheme: dark block).
+  Note: XML comments here must not contain a double hyphen, so the theme
+  tokens are named "color-x", not with their CSS custom-property prefix.
 -->
 <resources>
-    <!-- token --color-primary (dark). -->
+    <!-- token color-primary (dark). -->
     <color name="colorPrimary">#5FAE7E</color>
     <!-- Status-bar band + pre-WebView window in dark mode: the dark
-         --color-background, so the band is seamless with the dark app
-         below it rather than a stripe of light green. `windowLightStatusBar`
-         stays `false` (light icons) — correct against this near-black just
-         as it is against the light-mode dark-basil. -->
+         color-background, so the band is seamless with the dark app below
+         it rather than a stripe of light green. windowLightStatusBar stays
+         false (light icons), correct against this near-black just as it is
+         against the light-mode dark-basil. -->
     <color name="colorPrimaryDark">#14181A</color>
-    <!-- token --color-accent (dark). -->
+    <!-- token color-accent (dark). -->
     <color name="colorAccent">#EA7A48</color>
-    <!-- token --color-background (dark) — backs the splash / the window
+    <!-- token color-background (dark), backs the splash and the window
          while the WebView is still blank. -->
     <color name="colorBackground">#14181A</color>
 </resources>