diff --git a/oragono.yaml b/oragono.yaml
index e5762443..4854f650 100644
--- a/oragono.yaml
+++ b/oragono.yaml
@@ -1,4 +1,7 @@
-# oragono IRCd config
+# This is the default config file for Oragono.
+# It contains recommended defaults for all settings, including some behaviors
+# that differ from conventional ircds. See conventional.yaml for a config
+# with more "mainstream" behavior.
 
 # network configuration
 network: