diff --git a/etc/config b/etc/config
index 77966e8a..f08dac99 100644
--- a/etc/config
+++ b/etc/config
@@ -104,17 +104,8 @@ bindsym Mod1+Shift+minus move scratchpad
 # If there are multiple scratchpad windows, this command cycles through them.
 bindsym Mod1+minus scratchpad show
 
-# Define workspaces along with their labels
-#
-# Customize your workspace labels here.
-# Example:
-#
-# set $ws1 "Terminals" 
-#
-# or
-#
-# set $ws1 "1: Terminals"
-#
+# Define names for default workspaces for which we configure key bindings later on.
+# We use variables to avoid repeating the names in multiple places.
 set $ws1 "1"
 set $ws2 "2"
 set $ws3 "3"
diff --git a/etc/config.keycodes b/etc/config.keycodes
index 86eadb82..a22f1617 100644
--- a/etc/config.keycodes
+++ b/etc/config.keycodes
@@ -91,17 +91,8 @@ bindcode $mod+38 focus parent
 # focus the child container
 #bindsym $mod+d focus child
 
-# Define workspaces along with their labels
-#
-# Customize your workspace labels here.
-# Example:
-#
-# set $ws1 "Terminals" 
-#
-# or
-#
-# set $ws1 "1: Terminals"
-#
+# Define names for default workspaces for which we configure key bindings later on.
+# We use variables to avoid repeating the names in multiple places.
 set $ws1 "1"
 set $ws2 "2"
 set $ws3 "3"