diff --git a/src/branding/default/branding.desc b/src/branding/default/branding.desc
index 1bd76cd29..3d1079a8c 100644
--- a/src/branding/default/branding.desc
+++ b/src/branding/default/branding.desc
@@ -56,6 +56,9 @@ windowSize: 800px,520px
 # Note that ANSI_COLOR and CPE_NAME don't make sense here, and
 # are not supported (the rest are). Remember to quote the string
 # if it contains substitutions, or you'll get YAML exceptions.
+#
+# The *Url* entries are used on the welcome page, and they
+# are visible as buttons there if the corresponding *show* keys are set.
 strings:
     productName:         "@{NAME}"
     shortProductName:    Generic
@@ -84,7 +87,7 @@ strings:
 #       the window. Use `welcomeExpandingLogo` to make it non-scaled.
 #       Recommended size is 320x150.
 #
-# These strings can also use substitutions from os-release (see above).
+# These filenames can also use substitutions from os-release (see above).
 images:
     productLogo:         "squid.png"
     productIcon:         "squid.png"
diff --git a/src/modules/welcome/welcome.conf b/src/modules/welcome/welcome.conf
index a89b63854..a430345a2 100644
--- a/src/modules/welcome/welcome.conf
+++ b/src/modules/welcome/welcome.conf
@@ -7,6 +7,7 @@
 # can check requirements for installation.
 ---
 # Display settings for various buttons on the welcome page.
+# The URLs themselves come from branding.desc
 showSupportUrl:         true
 showKnownIssuesUrl:     true
 showReleaseNotesUrl:    true