diff --git a/config/fail2ban.conf b/config/fail2ban.conf
index ef77b3a4..a8e2eb9a 100644
--- a/config/fail2ban.conf
+++ b/config/fail2ban.conf
@@ -1,8 +1,12 @@
-# Fail2Ban configuration file
+# Fail2Ban main configuration file
 #
-# Author: Cyril Jaquier
+# Comments: use '#' for comment lines and ';' for inline comments
 #
-# $Revision$
+# Changes:  in most of the cases you should not modify this
+#           file, but provide customizations in fail2ban.local file, e.g.:
+#
+# [Definition]
+# loglevel = 4
 #
 
 [Definition]
diff --git a/config/jail.conf b/config/jail.conf
index 7e6c127c..fa527757 100644
--- a/config/jail.conf
+++ b/config/jail.conf
@@ -1,8 +1,15 @@
-# Fail2Ban configuration file
+# Fail2Ban jail specifications file
 #
-# Author: Cyril Jaquier
+# Comments: use '#' for comment lines and ';' for inline comments
 #
-# $Revision$
+# Changes:  in most of the cases you should not modify this
+#           file, but provide customizations in jail.local file, e.g.:
+#
+# [DEFAULT]
+# bantime = 3600
+#
+# [ssh-iptables]
+# enabled = true
 #
 
 # The DEFAULT allows a global definition of the options. They can be overridden