diff --git a/cspell.json b/cspell.json
index 5d459210f..4b6326a32 100644
--- a/cspell.json
+++ b/cspell.json
@@ -223,6 +223,7 @@
         "picocolors",
         "Pierzchała",
         "Pieter",
+        "Pipenv",
         "Pipfile",
         "pnpapi",
         "posix",
diff --git a/src/language-json/languages.evaluate.js b/src/language-json/languages.evaluate.js
index e1c372a12..949b686a3 100644
--- a/src/language-json/languages.evaluate.js
+++ b/src/language-json/languages.evaluate.js
@@ -1,15 +1,25 @@
 import * as linguistLanguages from "linguist-languages";
 import createLanguage from "../utils/create-language.js";
 
+// A list of files that are commonly generated by tools and should not be
+// formatted by the default JSON parser to avoid unwanted diffs.
+// These files are either formatted by the `json-stringify` parser or ignored.
 const ignoredFilenames = new Set([
-  // These are generated files, we don't want format them by default
+  // Bazel
   "MODULE.bazel.lock",
+  // Swift
   "Package.resolved",
+  // Pipenv
   "Pipfile.lock",
+  // Bun's text lockfile
   "bun.lock",
+  // Composer
   "composer.lock",
+  // Deno
   "deno.lock",
+  // Nix
   "flake.lock",
+  // Minecraft Forge
   "mcmod.info",
 ]);