Increased level of self-documentation of code (#17765)

Co-authored-by: fisker Cheung <lionkay@gmail.com>

cspell.json

@@ -223,6 +223,7 @@
         "picocolors",
         "Pierzchała",
         "Pieter",
+        "Pipenv",
         "Pipfile",
         "pnpapi",
         "posix",

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",
 ]);