refactor(): reword jsdoc for headless flag

Author: rwaskiewicz

src/cli/config-flags.ts

@@ -176,8 +176,12 @@ export const STRING_NUMBER_CLI_FLAGS = ['maxWorkers'] as const;
  */
 export const BOOLEAN_STRING_CLI_FLAGS = [
   /**
-   * `headless` is an argument that prior to Chrome v112, only accepted boolean values. Starting with Chrome v112,
-   * Stencil will accept a value of 'new' to support the new headless mode.
+   * `headless` is an argument passed through to Puppeteer (which is passed to Chrome) for end-to-end testing.
+   * Prior to Chrome v112, `headless` was treated like a boolean flag. Starting with Chrome v112, 'new' is an accepted
+   * option to support Chrome's new headless mode. In order to support this option in Stencil, both the boolean and
+   * string versions of the flag must be accepted.
+   *
+   * {@see https://developer.chrome.com/articles/new-headless/}
    */
   'headless',
 ] as const;