test(docs): improve option filtering in specs (#42846)

chore: improve option filtering in specs

Prior to this change, any time any option that had a defined `parents` property that
also had root-level markdown documentation would require an update to the
`getRequiredConfigSubOptions` and `getRequiredConfigSubOptions` functions in the
`documentation.spec.ts`.

After this change, that is no longer required as the functions
now consider an option root-level when it does not have a `parents` property,
`parents` is an empty array, or `parents` contains the root-level specifier (`.`).

Originally surfaced from #42671, but extracted to its own PR.

Author: justfalter

test/docs/documentation.spec.ts

@@ -50,19 +50,25 @@ describe('docs/documentation', () => {
           .map((match) =>
             match.substring(4, match.length - 1).replace(/^`|`$/g, ''),
           )
-          .filter(
-            (header) =>
-              header !== 'managerFilePatterns' && header !== 'enabled',
-          );
+          .filter((header) => header !== 'managerFilePatterns');
       }
 
       function getRequiredConfigOptions(): string[] {
-        return options
-          .filter((option) => !option.globalOnly)
-          .filter((option) => !option.parents)
-          .filter((option) => !option.autogenerated)
-          .map((option) => option.name)
-          .sort();
+        return (
+          options
+            .filter((option) => !option.globalOnly)
+            // Only include top-level options, which have no parents (implicit root) or explicitly define the
+            // root ('.') as their parent.
+            .filter(
+              (option) =>
+                !option.parents ||
+                option.parents.length === 0 ||
+                option.parents.includes('.'),
+            )
+            .filter((option) => !option.autogenerated)
+            .map((option) => option.name)
+            .sort()
+        );
       }
 
       it('has doc headers sorted alphabetically', async () => {
@@ -86,21 +92,25 @@ describe('docs/documentation', () => {
       }
 
       function getRequiredConfigSubOptions(): string[] {
-        return options
-          .filter((option) => option.stage !== 'global')
-          .filter((option) => !option.globalOnly)
-          .filter((option) => option.parents)
-          .filter(
-            (option) =>
-              option.name !== 'managerFilePatterns' &&
-              option.name !== 'enabled',
-          )
-          .flatMap((option) =>
-            (option.parents ?? [])
-              .filter((parent) => parent !== '.')
-              .map((parent) => `${parent}.${option.name}`),
-          )
-          .sort();
+        return (
+          options
+            .filter((option) => option.stage !== 'global')
+            .filter((option) => !option.globalOnly)
+            // Only include true sub-options: options which have parents but none of those are explicitly the root ('.').
+            .filter(
+              (option) =>
+                option.parents &&
+                option.parents.length > 0 &&
+                !option.parents.includes('.'),
+            )
+            .filter((option) => option.name !== 'managerFilePatterns')
+            .flatMap((option) =>
+              (option.parents ?? [])
+                .filter((parent) => parent !== '.')
+                .map((parent) => `${parent}.${option.name}`),
+            )
+            .sort()
+        );
       }
 
       function getParentNames(): Set<string> {