diff --git a/_config.yml b/_config.yml
index 6fa5c69b6a2c0..8e4b7eedacf5c 100644
--- a/_config.yml
+++ b/_config.yml
@@ -198,7 +198,7 @@ kramdown:
   enable_coderay: false
 
 
-# Collections
+# These settings control the types of collections used by the template
 collections:
   teaching:
     output: true
@@ -214,7 +214,7 @@ collections:
     permalink: /:collection/:path/
 
 
-# Defaults
+# These settings control how pages and collections are included in the site
 defaults:
   # _posts
   - scope:
diff --git a/_data/navigation.yml b/_data/navigation.yml
index 4997490d2fbd1..5959f5879b028 100644
--- a/_data/navigation.yml
+++ b/_data/navigation.yml
@@ -1,4 +1,9 @@
-# main links links
+# The following is the order of the links in the header of the website.
+#
+# Changing the order here will adjust the order and you can also add additional
+# links. Removing a link prevents it from showing in the header, but does not
+# prevent it from being included in the site.
+
 main:
   - title: "Publications"
     url: /publications/