From 8d01913f479179a38d0cdcb7ab43607413678a0c Mon Sep 17 00:00:00 2001
From: shadowusr <58862284+shadowusr@users.noreply.github.com>
Date: Fri, 20 Dec 2024 12:22:07 +0300
Subject: [PATCH] docs: add passive option disclaimer (#48)

---
 docs/config/browsers.mdx                                 | 9 ++++++---
 .../current/config/browsers.mdx                          | 8 +++++---
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/config/browsers.mdx b/docs/config/browsers.mdx
index 7746dca..79f291c 100644
--- a/docs/config/browsers.mdx
+++ b/docs/config/browsers.mdx
@@ -406,7 +406,8 @@ If the value is not set, the general timeout for all browsers, set with the [sys
             <td>`false`</td>
             <td>
                 Allows making the browser passive. In passive browsers, tests do not run by default.
-                _Available since testplane@8.16.0_.
+                _Available since testplane@8.16.0_. **Warning**: it currently has issues, read
+                below.
             </td>
         </tr>
         <tr>
@@ -467,8 +468,10 @@ This option guarantees strict order of reading tests. Default: `false`.
 ### passive {#passive}
 
 <Admonition type="warning">
-    Available since testplane@8.16.0. Does not work with the deprecated plugin
-    [hermione-passive-browsers](https://github.com/gemini-testing/testplane-passive-browsers).
+    Available since testplane@8.16.0.
+
+    This option currently doesn't work well with html-reporter. For now, we recommend to keep using the [hermione-passive-browsers](https://github.com/gemini-testing/testplane-passive-browsers) plugin. Note that the plugin and this option must not be used together. We're already working on a fix.
+
 </Admonition>
 
 Allows making the browser passive. In passive browsers, tests do not run by default. Using the helper [`testplane.also.in`][testplane-also-in-helper], you can enable a test or suite before it is run.
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/config/browsers.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/config/browsers.mdx
index 27d792b..80d9cbc 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/config/browsers.mdx
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/config/browsers.mdx
@@ -409,7 +409,7 @@ const browserOptions = {
             <td>`false`</td>
             <td>
                 Позволяет сделать браузер пассивным. В пассивных браузерах тесты не запускаются по
-                умолчанию. _Доступна с testplane@8.16.0_.
+                умолчанию. _Доступна с testplane@8.16.0_. **Внимание**: есть ограничения, см. ниже.
             </td>
         </tr>
         <tr>
@@ -470,8 +470,10 @@ interface FailedTestData {
 ### passive {#passive}
 
 <Admonition type="warning">
-    Доступна с testplane@8.16.0. Не работает вместе с устаревшим плагином
-    [hermione-passive-browsers](https://github.com/gemini-testing/testplane-passive-browsers).
+    Доступна с testplane@8.16.0.
+
+    В данный момент эта опция не работает с html-reporter. В данный момент мы рекомендуем продолжить использовать плагин [hermione-passive-browsers](https://github.com/gemini-testing/testplane-passive-browsers). Обратите внимание, что нельзя использовать плагин и эту опцию одновременно. Мы уже работаем над исправлением проблемы.
+
 </Admonition>
 
 Позволяет сделать браузер пассивным. В пассивных браузерах тесты не запускаются по умолчанию. С помощью хелпера [`testplane.also.in`][testplane-also-in-helper] можно включить тест или сьют, перед которым он указан.