fixup! tools: notify user if format-md needs to be run

Author: Trott

tools/lint-md/lint-md.mjs

@@ -29332,6 +29332,10 @@ const linter = unified()
 
 paths.forEach(async (path) => {
   const file = await read(path);
+  // We need to calculate `fileContents` before running `linter.process(files)`
+  // because `linter.process(files)` mutates `file` and returns it as `result`.
+  // So we won't be able to use `file` after that to see if its contents have
+  // changed as they will have been altered to the changed version.
   const fileContents = file.toString();
   const result = await linter.process(file);
   if (format) {

tools/lint-md/lint-md.src.mjs

@@ -28,6 +28,10 @@ const linter = unified()
 
 paths.forEach(async (path) => {
   const file = await read(path);
+  // We need to calculate `fileContents` before running `linter.process(files)`
+  // because `linter.process(files)` mutates `file` and returns it as `result`.
+  // So we won't be able to use `file` after that to see if its contents have
+  // changed as they will have been altered to the changed version.
   const fileContents = file.toString();
   const result = await linter.process(file);
   if (format) {