add comment for shouldKeepAdgHtmlFilteringRuleAsIs

Author: slvvko

src/main/utils/workaround.js

@@ -242,6 +242,23 @@ const HTML_RULES_PSEUDO_CLASS_MARKERS = [
     ':has-text(',
 ];
 
+/**
+ * Checks if the rule should be kept as is,
+ * i.e. no conversion and no validation,
+ * since it is not supported by the extension yet.
+ *
+ * Conditions for keeping the rule as is:
+ * - rule is HTML filtering rule
+ * - rule is AdGuard syntax
+ * - rule contains pseudo-class marker.
+ *
+ * Planned to be fixed:
+ * https://github.com/AdguardTeam/tsurlfilter/issues/96.
+ *
+ * @param {import('@adguard/agtree').AnyRule} ruleNode Rule node to check.
+ *
+ * @returns {boolean} True if the rule should be kept as is, otherwise false.
+ */
 export const shouldKeepAdgHtmlFilteringRuleAsIs = (ruleNode) => {
     return ruleNode.type === CosmeticRuleType.HtmlFilteringRule
         && ruleNode.syntax === AdblockSyntax.Adg