diff --git a/.gitattributes b/.gitattributes
index 96f3989b..6a47bab5 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,2 +1,5 @@
+# Fix how tsconfig.json files are displayed in GitHub's web view,
+# by telling it to read said files as JSON With Comments, the
+# JSON extension used by TypeScript.
 tsconfig.*.json linguist-language=JSON-with-Comments
 tsconfig.json linguist-language=JSON-with-Comments
\ No newline at end of file