[AGM-3116] Improved instructions for granting browser folder permissions

docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md

@@ -13,15 +13,19 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its
 
 ## Recommended solutions
 
-Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used.
+Since this issue can affect any Chromium- or Gecko-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used.
 
 ### Step 1: Grant access via Files & Folders
 
 1. Open *Files & Folders*
-    - via AdGuard settings: click the gear icon on the app’s main window → *Preferences…* → the *Assistant* tab → *Open Files & Folders*
-    ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png)
-    - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click *Open Files & Folders* — this button appears if AdGuard doesn’t have access to the browser’s folder
-    ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png)
+    - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click *Allow Access...* — this button appears if AdGuard doesn’t have access to the browser’s folder. You’ll be taken directly to the *Files & Folders* section
+    ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png)
+    - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...*
+
+    | | |
+    | :-: | :-: |
+    | ![AdGuard popup *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) |
+
     - via *System Settings* → *Privacy & Security* → *Files & Folders*
     ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png)
 1. Find *AdGuard* in the list and click it to expand the dropdown
@@ -40,12 +44,18 @@ A toggle for a specific browser will only appear in this list if the browser is
 Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission.
 
 1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system
-1. Open *Files & Folders* (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1)
+1. Open *Files & Folders* (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1)
 1. Find *AdGuard* in the list and click it to expand the dropdown
 1. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera).
 
 **Option B: Grant Full Disk Access**
 
+:::note
+
+Granting *Full Disk Access* is a last-resort measure: we strongly recommend trying the options above first. You should only enable it if you fully understand what you are doing. Full Disk Access is not required for AdGuard to work properly.
+
+:::
+
 1. Open *System Settings* → *Privacy & Security* → *Full Disk Access*
 1. Find *AdGuard* in the list and turn on the toggle
 ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png)