test,cli: improve cli documentation tests with mandoc generation

Author: avivkeller

doc/api/cli.md

@@ -592,14 +592,14 @@ Affects the default output directory of:
 
 ### `--disable-warning=code-or-type`
 
-> Stability: 1.1 - Active development
-
 <!-- YAML
 added:
   - v21.3.0
   - v20.11.0
 -->
 
+> Stability: 1.1 - Active development
+
 Disable specific process warnings by `code` or `type`.
 
 Warnings emitted from [`process.emitWarning()`][emit_warning] may contain a
@@ -832,8 +832,6 @@ node --entry-url 'data:text/javascript,console.log("Hello")'
 
 ### `--env-file=config`
 
-> Stability: 1.1 - Active development
-
 <!-- YAML
 added: v20.6.0
 changes:
@@ -844,6 +842,8 @@ changes:
     description: Add support to multi-line values.
 -->
 
+> Stability: 1.1 - Active development
+
 Loads environment variables from a file relative to the current directory,
 making them available to applications on `process.env`. The [environment
 variables which configure Node.js][environment_variables], such as `NODE_OPTIONS`,
@@ -1975,7 +1975,7 @@ Write reports in a compact format, single-line JSON, more easily consumable
 by log processing systems than the default multi-line format designed for
 human consumption.
 
-### `--report-dir=directory`, `report-directory=directory`
+### `--report-dir=directory`, `--report-directory=directory`
 
 <!-- YAML
 added: v11.8.0
@@ -3052,15 +3052,13 @@ one is included in the list below.
 * `--experimental-abortcontroller`
 * `--experimental-async-context-frame`
 * `--experimental-default-type`
-* `--experimental-detect-module`
 * `--experimental-eventsource`
 * `--experimental-import-meta-resolve`
 * `--experimental-json-modules`
 * `--experimental-loader`
 * `--experimental-modules`
 * `--experimental-permission`
 * `--experimental-print-required-tla`
-* `--experimental-require-module`
 * `--experimental-shadow-realm`
 * `--experimental-specifier-resolution`
 * `--experimental-sqlite`
@@ -3093,8 +3091,10 @@ one is included in the list below.
 * `--network-family-autoselection-attempt-timeout`
 * `--no-addons`
 * `--no-deprecation`
+* `--no-experimental-detect-module`
 * `--no-experimental-global-navigator`
 * `--no-experimental-repl-await`
+* `--no-experimental-require-module`
 * `--no-experimental-websocket`
 * `--no-extra-info-on-fatal-exception`
 * `--no-force-async-hooks-checks`