Add docs comment

benchmark/bench/server-stress.js

@@ -46,6 +46,9 @@ export async function run(projectDir, outputFile) {
 	console.log('='.repeat(10));
 	console.log(`#### Server stress\n\n`);
 	let text = autocannon.printResult(result);
+	// Truncate the logs in CI so that the generated comment from the `!bench` command
+	// is shortened. Also we only need this information when comparing runs.
+	// Full log example: https://github.com/mcollina/autocannon#command-line
 	if (process.env.CI) {
 		text = text.match(/^.*?requests in.*?read$/m)?.[0];
 	}

benchmark/ci-helper.js

@@ -1,3 +1,6 @@
+// This script helps extract the benchmark logs that are between the `==========` lines.
+// They are a convention defined in the `./bench/_template.js` file, which are used to log
+// out with the `!bench` command. See `/.github/workflows/benchmark.yml` to see how it's used.
 const benchLogs = process.argv[2];
 const resultRegex = /==========(.*?)==========/gs;