diff --git a/docs/customization.md b/docs/customization.md
index 34b28d497..40b64e2ff 100644
--- a/docs/customization.md
+++ b/docs/customization.md
@@ -100,7 +100,7 @@ assets may also be put in the `overrides` directory:
 │  │  └─ analytics.html                # Analytics setup
 │  ├─ languages/                       # Translation languages
 │  ├─ actions.html                     # Actions
-│  ├─ alternate.html                   # Translation language selector
+│  ├─ alternate.html                   # Site language selector
 │  ├─ comments.html                    # Comment system (empty by default)
 │  ├─ consent.html                     # Consent
 │  ├─ content.html                     # Page content
diff --git a/src/partials/alternate.html b/src/partials/alternate.html
index 0a83e97ff..7d7c925b0 100644
--- a/src/partials/alternate.html
+++ b/src/partials/alternate.html
@@ -20,6 +20,7 @@
   IN THE SOFTWARE.
 -->
 
+<!-- Site language selector -->
 <div class="md-header__option">
   <div class="md-select">
     {% set icon = config.theme.icon.alternate or "material/translate" %}
diff --git a/src/partials/header.html b/src/partials/header.html
index 11eac459f..9b6d2e2e3 100644
--- a/src/partials/header.html
+++ b/src/partials/header.html
@@ -72,7 +72,7 @@
       </div>
     </div>
 
-    <!-- Color palette -->
+    <!-- Color palette toggle -->
     {% if config.theme.palette %}
       {% if not config.theme.palette is mapping %}
         {% include "partials/palette.html" %}
diff --git a/src/partials/palette.html b/src/partials/palette.html
index a98b2199a..ccb8db0a1 100644
--- a/src/partials/palette.html
+++ b/src/partials/palette.html
@@ -20,6 +20,7 @@
   IN THE SOFTWARE.
 -->
 
+<!-- Color palette toggle -->
 <form class="md-header__option" data-md-component="palette">
   {% for option in config.theme.palette %}
     {% set scheme  = option.scheme  | d("default", true) %}