diff --git a/changelog.d/5926.misc b/changelog.d/5926.misc
new file mode 100644
index 000000000000..4383c302eccf
--- /dev/null
+++ b/changelog.d/5926.misc
@@ -0,0 +1 @@
+Add link in sample config to the logging config schema.
diff --git a/docs/sample_config.yaml b/docs/sample_config.yaml
index a580d721d28c..f88475d1d824 100644
--- a/docs/sample_config.yaml
+++ b/docs/sample_config.yaml
@@ -560,7 +560,8 @@ database:
 
 ## Logging ##
 
-# A yaml python logging config file
+# A yaml python logging config file as described by
+# https://docs.python.org/3.7/library/logging.config.html#configuration-dictionary-schema
 #
 log_config: "CONFDIR/SERVERNAME.log.config"
 
diff --git a/synapse/config/logger.py b/synapse/config/logger.py
index 981df5a10c27..2704c18720df 100644
--- a/synapse/config/logger.py
+++ b/synapse/config/logger.py
@@ -89,7 +89,8 @@ def generate_config_section(self, config_dir_path, server_name, **kwargs):
             """\
         ## Logging ##
 
-        # A yaml python logging config file
+        # A yaml python logging config file as described by
+        # https://docs.python.org/3.7/library/logging.config.html#configuration-dictionary-schema
         #
         log_config: "%(log_config)s"
         """