Merge branch 'feature/md-lint' of ssh://bit.adguard.com:7999/adguard-…

…filters/scriptlets into feature/md-lint

src/redirects/static-redirects.yml

@@ -150,7 +150,7 @@
   added: v1.3.9
   description: |-
     Pretty much the same as `nooptext`. Used for conversion of modifier `empty`
-    so better avoid its using in production filter lists.
+    so better avoid its using in prod versions of filter lists.
 
     ### Examples
 

src/scriptlets/debug-current-inline-script.js

@@ -19,7 +19,7 @@ import {
  * This scriptlet is basically the same as [abort-current-inline-script](#abort-current-inline-script),
  * but instead of aborting it starts the debugger.
  *
- * > **It is not supposed to be used in production filter lists!**
+ * > It is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/debug-on-property-read.js

@@ -18,7 +18,7 @@ import {
  * This scriptlet is basically the same as [abort-on-property-read](#abort-on-property-read),
  * but instead of aborting it starts the debugger.
  *
- * > **It is not supposed to be used in production filter lists!**
+ * > It is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/debug-on-property-write.js

@@ -17,7 +17,7 @@ import {
  * This scriptlet is basically the same as [abort-on-property-write](#abort-on-property-write),
  * but instead of aborting it starts the debugger.
  *
- * > **This scriptlet is not allowed to be used in production filter lists!**
+ * > It is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/m3u-prune.js

@@ -34,7 +34,7 @@ import {
  * - `urlToMatch` — optional, string or regular expression for matching the request's URL
  *
  * > Usage with no arguments will log response payload and URL to browser console;
- * > which is useful for debugging but prohibited for production filter lists.
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/prevent-fetch.js

@@ -52,7 +52,7 @@ import {
  *     - `opaque`
  *
  * > Usage with no arguments will log fetch calls to browser console;
- * > which is useful for debugging but not permitted for production filter lists.
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/prevent-requestAnimationFrame.js

@@ -33,8 +33,8 @@ import {
  *   If starts with `!`, scriptlet will not match the stringified callback but all other will be defused.
  *   If do not start with `!`, the stringified callback will be matched.
  *
- * > Call with no argument will log all requestAnimationFrame calls while debugging.
- * > So do not use the scriptlet without any parameter in production filter lists.
+ * > Call with no argument will log all requestAnimationFrame calls,
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/prevent-setInterval.js

@@ -37,8 +37,8 @@ import {
  * example.org#%#//scriptlet('prevent-setInterval'[, matchCallback[, matchDelay]])
  * ```
  *
- * Call with no arguments will log calls to setInterval while debugging (`log-setInterval` superseding),
- * so production filter lists' rules definitely require at least one of the parameters:
+ * > Call with no arguments will log all setInterval calls (`log-setInterval` superseding),
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * - `matchCallback` — optional, string or regular expression;
  *   invalid regular expression will be skipped and all callbacks will be matched.

src/scriptlets/prevent-setTimeout.js

@@ -37,8 +37,8 @@ import {
  * example.org#%#//scriptlet('prevent-setTimeout'[, matchCallback[, matchDelay]])
  * ```
  *
- * Call with no arguments will log calls to setTimeout while debugging (`log-setTimeout` superseding),
- * so production filter lists' rules definitely require at least one of the parameters:
+ * > Call with no arguments will log all setTimeout calls (`log-setTimeout` superseding),
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * - `matchCallback` — optional, string or regular expression;
  *   invalid regular expression will be skipped and all callbacks will be matched.

src/scriptlets/prevent-window-open.js

@@ -45,7 +45,7 @@ import {
  * - `replacement` — optional, string; one of the predefined constants:
  *     - `obj` — for returning an object instead of default iframe;
  *        for cases when the page requires a valid `window` instance to be returned
- *     - `log` — for logging window.open calls; not allowed for production filter lists.
+ *     - `log` — for logging window.open calls; not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/prevent-xhr.js

@@ -53,7 +53,7 @@ import {
  *         - `value` — range on numbers, for example `100-300`, limited to 500000 characters
  *
  * > Usage with no arguments will log XMLHttpRequest objects to browser console;
- * > which is useful for debugging but not allowed for production filter lists.
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/trusted-replace-fetch-response.js

@@ -47,7 +47,7 @@ import {
  *           invalid regular expression will cause any value matching
  *
  * > Usage with no arguments will log fetch calls to browser console;
- * > may be is useful for debugging, and not allowed for production filter lists.
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * > Scriptlet does nothing if response body can't be converted to text.
  *

src/scriptlets/trusted-replace-xhr-response.js

@@ -44,7 +44,7 @@ import {
  *           passed to `XMLHttpRequest.open()` call
  *
  * > Usage with no arguments will log XMLHttpRequest objects to browser console;
- * > which is useful for debugging but not permitted for production filter lists.
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *

src/scriptlets/xml-prune.js

@@ -34,7 +34,7 @@ import {
  * - `urlToMatch` — optional, string or regular expression for matching the request's URL
  *
  * > Usage with no arguments will log response payload and URL to browser console;
- * > which is useful for debugging but prohibited for production filter lists.
+ * > it may be useful for debugging but it is not allowed for prod versions of filter lists.
  *
  * ### Examples
  *