code review

Author: avivkeller

README.md

@@ -23,61 +23,18 @@
 
 ## Usage
 
-### `help`
-
-```sh
-npx api-docs-tooling help [command]
-```
-
-### `generate`
-
-Generate API documentation from Markdown files.
-
-```sh
-npx api-docs-tooling generate [options]
-```
-
-**Options:**
-
-- `-i, --input <patterns...>` Input file patterns (glob)
-- `--ignore [patterns...]` Files to ignore
-- `-o, --output <dir>` Output directory
-- `-v, --version <semver>` Target Node.js version (default: latest)
-- `-c, --changelog <url>` Changelog file or URL
-- `--git-ref <url>` Git ref/commit URL
-- `-t, --target [modes...]` Generator target(s): `json-simple`, `legacy-html`, etc.
-- `--no-lint` Skip linting before generation
-
-### `lint`
-
-Run the linter on API documentation.
-
-```sh
-npx api-docs-tooling lint [options]
 ```
+Usage: api-docs-tooling [options] [command]
 
-**Options:**
-
-- `-i, --input <patterns...>` Input file patterns (glob)
-- `--ignore [patterns...]` Files to ignore
-- `--disable-rule [rules...]` Disable specific linting rules
-- `--dry-run` Run linter without applying changes
-- `-r, --reporter <reporter>` Reporter format: `console`, `github`, etc.
+CLI tool to generate and lint Node.js API documentation
 
-### `interactive`
+Options:
+  -h, --help          display help for command
 
-Launches a fully interactive CLI prompt to guide you through all available options.
-
-```sh
-npx api-docs-tooling interactive
-```
-
-### `list`
-
-See available modules for each subsystem.
-
-```sh
-npx api-docs-tooling list generators
-npx api-docs-tooling list rules
-npx api-docs-tooling list reporters
-```
+Commands:
+  generate [options]  Generate API docs
+  lint [options]      Run linter independently
+  interactive         Launch guided CLI wizard
+  list <types>        List the given type
+  help [command]      display help for command
+```

bin/cli.mjs

@@ -49,14 +49,5 @@ program
   .description('List the given type')
   .action(list);
 
-// Register the help command
-program
-  .command('help [cmd]')
-  .description('Show help for a command')
-  .action(cmdName => {
-    const target = program.commands.find(c => c.name() === cmdName) ?? program;
-    target.help();
-  });
-
 // Parse and execute command-line arguments
 program.parse(process.argv);