Better describe the snapshot testing

Author: jonathanKingston

CODEOWNERS

@@ -14,4 +14,5 @@ inject/chrome.js @jonathanKingston @sammacbeth
 inject/windows.js @jonathanKingston @q71114 @szanto90balazs
 
 # Test owners
-integration-tests/test-pages/ @kdzwinel @jonathanKingston
+integration-tests/test-pages/ @kdzwinel @jonathanKingston
+unit-tests/script-overload-snapshots/ @shakyShane @jonathanKingston @englehardt

scripts/generateOverloadSnapshots.js

@@ -3,11 +3,13 @@ import { wrapScriptCodeOverload } from '../src/features/runtime-checks/script-ov
 import { join } from 'node:path'
 import { readFileSync, writeFileSync, readdirSync } from 'node:fs'
 import { cwd } from './script-utils.js'
-
-// path helpers
 const ROOT = join(cwd(import.meta.url))
 const configPath = join(ROOT, '../unit-test/script-overload-snapshots/config')
 
+/**
+ * Generates a bunch of snapshots for script-overload.js results using the configs.
+ * These are used in unit-test/script-overload.js and ran automatically in automation so that we verify the output is correct.
+ */
 function generateOut () {
     const files = readdirSync(configPath)
     for (const fileName of files) {

unit-test/script-overload.js

@@ -3,13 +3,12 @@ import { wrapScriptCodeOverload } from '../src/features/runtime-checks/script-ov
 import { join } from 'node:path'
 import { readFileSync, readdirSync } from 'node:fs'
 import { cwd } from '../scripts/script-utils.js'
-
-// path helpers
 const ROOT = join(cwd(import.meta.url))
 const configPath = join(ROOT, '/script-overload-snapshots/config')
 
 describe('Output validation', () => {
     it('Given the correct config we should generate expected code output', () => {
+        // Uses the snapshots generated in scripts/generateOverloadSnapshots.js to ensure we don't break the output.
         const files = readdirSync(configPath)
         for (const fileName of files) {
             const config = readFileSync(join(configPath, fileName)).toString()