fixup!: re-organise examples

Author: JakobJingleheimer

apps/site/pages/en/learn/test-runner/using-test-runner.md

@@ -68,47 +68,49 @@ Each example below was taken from real-world projects; they may not be appropria
 
 Some times, you may want to dynamically generate test-cases. For instance, you want to test the same thing across a bunch of files. This is possible, albeit slightly arcane. You must use `test` (you cannot use `describe`) + `testContext.test`:
 
-```js displayName="simple example (prior to 23.8.0)"
+### Simple example
+
+```js displayName="23.8.0 and later"
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 
 import { detectOsInUserAgent } from '…';
 
 const userAgents = [
-  { ua: '…', os: 'WIN' },
+  { ua: /* … */, os: 'WIN' },
   // …
 ];
 
-test('Detect OS via user-agent', { concurrency: true }, async t => {
-  const cases = userAgents.map(({ os, ua }) => {
+test('Detect OS via user-agent', { concurrency: true }, t => {
+  for (const { os, ua } from userAgents) {
     t.test(ua, () => assert.equal(detectOsInUserAgent(ua), os));
-  });
-
-  await Promise.allSettled(cases);
+  }
 });
 ```
 
-```js displayName="simple example (23.8.0 and later)"
+```js displayName="prior to 23.8.0"
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 
 import { detectOsInUserAgent } from '…';
 
 const userAgents = [
-  { ua: /* … */, os: 'WIN' },
+  { ua: '…', os: 'WIN' },
   // …
 ];
 
-test('Detect OS via user-agent', { concurrency: true }, t => {
-  for (const { os, ua } from userAgents) {
+test('Detect OS via user-agent', { concurrency: true }, async t => {
+  const cases = userAgents.map(({ os, ua }) => {
     t.test(ua, () => assert.equal(detectOsInUserAgent(ua), os));
-  }
+  });
+
+  await Promise.allSettled(cases);
 });
 ```
 
-<!-- separate groups -->
+### Advanced example
 
-```js displayName="Advanced example (prior to 23.8.0)"
+```js displayName="23.8.0 and later"
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 
@@ -119,19 +121,16 @@ const requiredKeywords = ['node.js', 'sliced bread'];
 test('Check package.jsons', { concurrency: true }, async t => {
   const pjsons = await getWorkspacePJSONs();
 
-  const cases = pjsons.map(pjson =>
+  for (const pjson of pjsons) {
     // ⚠️ `t.test`, NOT `test`
     t.test(`Ensure fields are properly set: ${pjson.name}`, () => {
       assert.partialDeepStrictEqual(pjson.keywords, requiredKeywords);
-    })
-  );
-
-  // Allow the cases to run concurrently.
-  await Promise.allSettled(cases);
+    });
+  }
 });
 ```
 
-```js displayName="Advanced example (23.8.0 and later)"
+```js displayName="prior to 23.8.0"
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 
@@ -142,12 +141,15 @@ const requiredKeywords = ['node.js', 'sliced bread'];
 test('Check package.jsons', { concurrency: true }, async t => {
   const pjsons = await getWorkspacePJSONs();
 
-  for (const pjson of pjsons) {
+  const cases = pjsons.map(pjson =>
     // ⚠️ `t.test`, NOT `test`
     t.test(`Ensure fields are properly set: ${pjson.name}`, () => {
       assert.partialDeepStrictEqual(pjson.keywords, requiredKeywords);
-    });
-  }
+    })
+  );
+
+  // Allow the cases to run concurrently.
+  await Promise.allSettled(cases);
 });
 ```