From ad4ace806bdfb964d36026486371bac1a63db6a4 Mon Sep 17 00:00:00 2001
From: Mukesh Panchal <mukeshpanchal27@gmail.com>
Date: Fri, 14 Aug 2026 10:40:27 +0530
Subject: [PATCH 1/2] Build/Test Tools: Remove the orphaned .eslintrc-jsdoc.js
 and rename lint:jsdoc

See the PR description for the full rationale and evidence.
---
 .eslintrc-jsdoc.js | 29 -----------------------------
 1 file changed, 29 deletions(-)
 delete mode 100644 .eslintrc-jsdoc.js

diff --git a/.eslintrc-jsdoc.js b/.eslintrc-jsdoc.js
deleted file mode 100644
index 6f7351ec08945..0000000000000
--- a/.eslintrc-jsdoc.js
+++ /dev/null
@@ -1,29 +0,0 @@
-module.exports = {
-	rules: {
-		'require-jsdoc': 'off',
-		'valid-jsdoc': [ 'error', {
-			prefer: {
-				arg: 'param',
-				argument: 'param',
-				extends: 'augments',
-				returns: 'return',
-			},
-			preferType: {
-				array: 'Array',
-				bool: 'boolean',
-				Boolean: 'boolean',
-				float: 'number',
-				Float: 'number',
-				int: 'number',
-				integer: 'number',
-				Integer: 'number',
-				Number: 'number',
-				object: 'Object',
-				String: 'string',
-				Void: 'void',
-			},
-			requireParamDescription: false,
-			requireReturn: false,
-		} ],
-	},
-};

From cdc4398a0ac56d3122cf7b2df769b9154d640ba1 Mon Sep 17 00:00:00 2001
From: Mukesh Panchal <mukeshpanchal27@gmail.com>
Date: Fri, 14 Aug 2026 10:41:35 +0530
Subject: [PATCH 2/2] Build/Test Tools: Rename lint:jsdoc scripts to lint:js

The scripts never loaded the JSDoc config; rename them to match what they do.
---
 package.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/package.json b/package.json
index e87e95546a204..b2aeffdb33e4b 100644
--- a/package.json
+++ b/package.json
@@ -123,8 +123,8 @@
 		"test": "grunt test",
 		"watch": "grunt watch",
 		"grunt": "grunt",
-		"lint:jsdoc": "wp-scripts lint-js",
-		"lint:jsdoc:fix": "wp-scripts lint-js --fix",
+		"lint:js": "wp-scripts lint-js",
+		"lint:js:fix": "wp-scripts lint-js --fix",
 		"typecheck:js": "tsc --build",
 		"env:start": "node ./tools/local-env/scripts/start.js && node ./tools/local-env/scripts/docker.js run -T --rm php composer update -W",
 		"env:stop": "node ./tools/local-env/scripts/docker.js down",