diff --git a/debian/etc/taler/taler.conf b/debian/etc/taler/taler.conf
index 2c592527d..911abec28 100644
--- a/debian/etc/taler/taler.conf
+++ b/debian/etc/taler/taler.conf
@@ -2,16 +2,22 @@
 #
 # Structure:
 # - taler.conf is the main configuration entry point
-#   used by all Taler components
+#   used by all Taler components (the file you are currently
+#   looking at.
+# - overrides.conf contains configuration overrides that are
+#   set by some tools that help with the configuration,
+#   and should not be edited by humands.  Comments in this file
+#   are not preserved.
 # - conf.d/ contains configuration files for
 #   Taler components, which can be read by all
 #   users of the system and are included by the main
-#   configuration
+#   configuration.
 # - secrets/ contains configuration snippets
 #   with secrets for particular services.
 #   These files should have restrictive permissions
 #   so that only users of the relevant services
-#   can read it.
+#   can read it.  All files in it should end with
+#   ".secret.conf".
 
 [taler]