Disable JSDoc requirements that are not upheld anyway

fatso83 · fatso83 · commit d2a16b99f2b9 · 2023-10-20T16:46:17.000+02:00
diff --git a/.eslintrc.yml b/.eslintrc.yml
@@ -6,3 +6,6 @@ plugins:
 
 rules:
   "@sinonjs/no-prototype-methods/no-prototype-methods": error
+  "jsdoc/require-param-type": off
+  "jsdoc/require-jsdoc": off
+  "jsdoc/tag-lines": off
diff --git a/lib/sinon/proxy-call.js b/lib/sinon/proxy-call.js
@@ -261,6 +261,8 @@ callProto.invokeCallback = callProto.yield;
  * @param exception
  * @param id
  * @param errorWithCallStack
+ *
+ * @returns {object} proxyCall
  */
 function createProxyCall(
     proxy,
diff --git a/lib/sinon/spy-formatters.js b/lib/sinon/spy-formatters.js
@@ -18,6 +18,8 @@ const slice = arrayProto.slice;
  * @param matcher
  * @param calledArg
  * @param calledArgMessage
+ *
+ * @returns {string} the colored text
  */
 function colorSinonMatchText(matcher, calledArg, calledArgMessage) {
     let calledArgumentMessage = calledArgMessage;
@@ -32,8 +34,9 @@ function colorSinonMatchText(matcher, calledArg, calledArgMessage) {
 }
 
 /**
- *
  * @param diff
+ *
+ * @returns {string} the colored diff
  */
 function colorDiffText(diff) {
     const objects = map(diff, function (part) {
@@ -54,6 +57,7 @@ function colorDiffText(diff) {
 /**
  *
  * @param value
+ * @returns {string} a quoted string
  */
 function quoteStringValue(value) {
     if (typeof value === "string") {
diff --git a/lib/sinon/util/fake-timers.js b/lib/sinon/util/fake-timers.js
@@ -8,6 +8,8 @@ const globalObject = require("@sinonjs/commons").global;
  *
  * @param config
  * @param globalCtx
+ *
+ * @returns {object} the clock, after installing it on the global context, if given
  */
 function createClock(config, globalCtx) {
     let FakeTimersCtx = FakeTimers;
diff --git a/package.json b/package.json
@@ -47,7 +47,7 @@
     "dev-docs": "cd docs; rsync -r --delete release-source/ releases/dev; npm run serve-docs",
     "build-docs": "cd docs; bundle exec jekyll build",
     "serve-docs": "cd docs; bundle exec jekyll serve --incremental --verbose --livereload",
-    "lint": "eslint --max-warnings 101 '**/*.{js,cjs,mjs}'",
+    "lint": "eslint --max-warnings 0 '**/*.{js,cjs,mjs}'",
     "unimported": "unimported .",
     "pretest-webworker": "npm run build",
     "prebuild": "rimraf pkg && npm run check-dependencies",

Original file line number	Diff line number	Diff line change
`@@ -8,6 +8,8 @@ const globalObject = require("@sinonjs/commons").global;`
`8`	`8`	`*`
`9`	`9`	`* @param config`
`10`	`10`	`* @param globalCtx`
	`11`	`+ *`
	`12`	`+ * @returns {object} the clock, after installing it on the global context, if given`
`11`	`13`	`*/`
`12`	`14`	`function createClock(config, globalCtx) {`
`13`	`15`	`let FakeTimersCtx = FakeTimers;`