diff --git a/lib/linguist/content_types.yml b/lib/linguist/content_types.yml
index c2a0d9cb..96a5d146 100644
--- a/lib/linguist/content_types.yml
+++ b/lib/linguist/content_types.yml
@@ -1,3 +1,5 @@
+# MIME types and extensions to override when the raw blob is served
+
 # mime types
 application/rdf+xml: text/plain
 application/sh: text/plain
diff --git a/lib/linguist/languages.yml b/lib/linguist/languages.yml
index ea89e81e..35491383 100644
--- a/lib/linguist/languages.yml
+++ b/lib/linguist/languages.yml
@@ -1,6 +1,8 @@
-# This file maps file extensions and exact file names to languages.
-# If the key begins with a `.`, it's an extension.
-# Anything else will only match exactly, albeit case insensitively.
+# Defines all Lanaguges known to GitHub
+#
+# lexer - An explicit lexer String (defaults to name.downcase)
+# ext   - An Array of associated extensions
+
 ASP:
   :lexer: aspx-vb
   :ext: