diff --git a/lib/linguist/languages.yml b/lib/linguist/languages.yml
index 86ba92ec..46bbd766 100644
--- a/lib/linguist/languages.yml
+++ b/lib/linguist/languages.yml
@@ -9,7 +9,8 @@
 # aliases     - An Array of additional aliases (implicitly
 #               includes name.downcase)
 # extension   - An Array of associated extensions
-# major       - Boolean flag major programming languages
+# major       - Boolean flag major programming languages. Please leave
+#               this option to GitHub staff to decide.
 # searchable  - Boolean flag to enable searching (defaults to true)
 # search_term - Deprecated: Some languages maybe indexed under a
 #               different alias. Avoid defining new exceptions.