tools_intellij_platform_gradle_plugin_faq.md: document muting specific problems for verifyPlugin task

topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_faq.md

@@ -80,6 +80,23 @@ See [Migrating from Gradle IntelliJ Plugin](tools_intellij_platform_gradle_plugi
 
 See the [](bundling_plugin_openapi_sources.md) section for details.
 
+### How to mute specific problems in `verifyPlugin`?
+
+To mute specific problems (for example, use of specific forbidden words in plugin name) use [`freeArgs`](tools_intellij_platform_gradle_plugin_tasks.md#verifyPlugin-freeArgs)
+parameter to pass a comma-separated list of problem IDs to be muted.
+
+See the list of [available options](https://github.com/JetBrains/intellij-plugin-verifier/?tab=readme-ov-file#specific-options).
+
+```kotlin
+ verifyPlugin {
+        // ...
+        freeArgs = listOf(
+            "-mute",
+            "TemplateWordInPluginId,ForbiddenPluginIdPrefix"
+        )
+    }
+```
+
 ### JaCoCo Reports 0% Coverage
 
 The Gradle IntelliJ Plugin, when targeting the IntelliJ SDK `2022.1+`, uses the `PathClassLoader` class loader by the following system property:

topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_tasks.md

@@ -1675,6 +1675,8 @@ Default value
 Represents a list of free arguments that are passed directly to the IntelliJ Plugin Verifier CLI tool.
 These arguments are used in conjunction with those provided by dedicated options.
 
+See [](tools_intellij_platform_gradle_plugin_faq.md#how-to-mute-specific-problems-in-verifyplugin) for sample usage.
+
 {style="narrow"}
 Type
 : `ListProperty<String>`