From 727b26a74b06cdbe579309ea0e9f130201573e46 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 6 May 2026 20:18:14 +0000 Subject: [PATCH 1/3] docs: trim stale `@param` tags in `_tools/makie/plugins/makie-list-pkgs-names` The plugin's JSDoc documented a `subpath` parameter that the function signature does not accept and the body never references. Removed the stale tag so the JSDoc matches the actual `( dir, cwd )` signature, in line with the namespace convention (e.g. `makie-repl` documents only the parameters its implementation uses). The 3-param signature is the majority pattern at 19/23 (82.6%); the trimmed-JSDoc-matches-signature sub-pattern is the convention for the minority of plugins that legitimately accept fewer parameters. --- .../_tools/makie/plugins/makie-list-pkgs-names/lib/main.js | 1 - 1 file changed, 1 deletion(-) diff --git a/lib/node_modules/@stdlib/_tools/makie/plugins/makie-list-pkgs-names/lib/main.js b/lib/node_modules/@stdlib/_tools/makie/plugins/makie-list-pkgs-names/lib/main.js index 735ab71a2582..d907de7d7ace 100644 --- a/lib/node_modules/@stdlib/_tools/makie/plugins/makie-list-pkgs-names/lib/main.js +++ b/lib/node_modules/@stdlib/_tools/makie/plugins/makie-list-pkgs-names/lib/main.js @@ -79,7 +79,6 @@ function stderr( data ) { * * @param {string} dir - Makefile directory * @param {string} cwd - current working directory -* @param {string} subpath - subdirectory path */ function plugin( dir, cwd ) { var opts; From a3f3a2a7526625d98bb3479b6c3a37dfd87ed299 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 6 May 2026 20:18:18 +0000 Subject: [PATCH 2/3] docs: trim stale `@param` tags in `_tools/makie/plugins/makie-view-complexity` The plugin's JSDoc documented `cwd` and `subpath` parameters that the function signature does not accept and the body never references. Removed the stale tags so the JSDoc matches the actual `( dir )` signature. The 3-param signature is the majority pattern at 19/23 (82.6%); the convention for the minority that legitimately take fewer parameters is to document only what the implementation accepts (e.g. `makie-repl`). --- .../_tools/makie/plugins/makie-view-complexity/lib/main.js | 2 -- 1 file changed, 2 deletions(-) diff --git a/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-complexity/lib/main.js b/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-complexity/lib/main.js index 52acc6078cd2..0a2355add9d5 100644 --- a/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-complexity/lib/main.js +++ b/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-complexity/lib/main.js @@ -78,8 +78,6 @@ function stderr( data ) { * Plugin to view a complexity report. * * @param {string} dir - Makefile directory -* @param {string} cwd - current working directory -* @param {string} subpath - subdirectory path */ function plugin( dir ) { var opts; From c69ee8b3f7b7789fdab3eb45e8a541f5c54f94a6 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 6 May 2026 20:18:24 +0000 Subject: [PATCH 3/3] docs: trim stale `@param` tags in `_tools/makie/plugins/makie-view-cov` The plugin's JSDoc documented `cwd` and `subpath` parameters that the function signature does not accept and the body never references. Removed the stale tags so the JSDoc matches the actual `( dir )` signature. The 3-param signature is the majority pattern at 19/23 (82.6%); the convention for the minority that legitimately take fewer parameters is to document only what the implementation accepts (e.g. `makie-repl`). --- .../@stdlib/_tools/makie/plugins/makie-view-cov/lib/main.js | 2 -- 1 file changed, 2 deletions(-) diff --git a/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-cov/lib/main.js b/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-cov/lib/main.js index 2e633ddb5c3f..c13c1a8138e1 100644 --- a/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-cov/lib/main.js +++ b/lib/node_modules/@stdlib/_tools/makie/plugins/makie-view-cov/lib/main.js @@ -78,8 +78,6 @@ function stderr( data ) { * Plugin to view a test coverage report. * * @param {string} dir - Makefile directory -* @param {string} cwd - current working directory -* @param {string} subpath - subdirectory path */ function plugin( dir ) { var opts;