Update the UC Mode docs

Author: mdmintz

help_docs/uc_mode.md

@@ -22,14 +22,14 @@
 * Automatically setting various chromium args as needed.
 * Has special `uc_*()` methods.
 
-👤 Here's an example with the <b><code translate="no">Driver</code></b> manager:
+👤 Here's a simple example with the <b><code translate="no">Driver</code></b> manager:
 
 ```python
 from seleniumbase import Driver
 
 driver = Driver(uc=True)
 url = "https://gitlab.com/users/sign_in"
-driver.uc_open_with_reconnect(url, 3)
+driver.uc_open_with_reconnect(url, 4)
 driver.quit()
 ```
 
@@ -42,21 +42,22 @@ from seleniumbase import SB
 
 with SB(uc=True) as sb:
     url = "https://gitlab.com/users/sign_in"
-    sb.uc_open_with_reconnect(url, 3)
+    sb.uc_open_with_reconnect(url, 4)
 ```
 
-👤 Here's a longer example, which includes a retry if the CAPTCHA isn't bypassed on the first attempt:
+👤 Here's a longer example, which includes a special click if the CAPTCHA isn't bypassed on the initial page load:
 
 ```python
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
     url = "https://gitlab.com/users/sign_in"
-    sb.uc_open_with_reconnect(url, 3)
-    if not sb.is_text_visible("Username", '[for="user_login"]'):
-        sb.uc_open_with_reconnect(url, 4)
+    sb.uc_open_with_reconnect(url, 4)
+    sb.uc_gui_click_captcha()
     sb.assert_text("Username", '[for="user_login"]', timeout=3)
-    sb.highlight('label[for="user_login"]', loops=3)
+    sb.assert_element('label[for="user_login"]')
+    sb.highlight('button:contains("Sign in")')
+    sb.highlight('h1:contains("GitLab.com")')
     sb.post_message("SeleniumBase wasn't detected", duration=4)
 ```
 
@@ -78,21 +79,22 @@ with SB(uc=True, test=True) as sb:
 
 <img src="https://seleniumbase.github.io/other/turnstile_click.jpg" title="SeleniumBase" width="440">
 
-If running on a Linux server, `uc_gui_handle_cf()` might not be good enough. Switch to `uc_gui_click_cf()` to be more stealthy. You can also use `uc_gui_click_captcha()` as a generic CAPTCHA-clicker, which auto-detects between CF Turnstile and reCAPTCHA.
+If running on a Linux server, `uc_gui_handle_cf()` might not be good enough. Switch to `uc_gui_click_cf()` to be more stealthy. You can also use `uc_gui_click_captcha()` as a generic CAPTCHA-clicker, which auto-detects between CF Turnstile and Google reCAPTCHA.
 
 👤 Here's an example <b>where the CAPTCHA appears after submitting a form</b>:
 
 ```python
 from seleniumbase import SB
 
-with SB(uc=True, test=True, locale_code="en") as sb:
+with SB(uc=True, test=True, incognito=True, locale_code="en") as sb:
     url = "https://ahrefs.com/website-authority-checker"
     input_field = 'input[placeholder="Enter domain"]'
     submit_button = 'span:contains("Check Authority")'
-    sb.uc_open_with_reconnect(url, 1)  # The bot-check is later
+    sb.uc_open_with_reconnect(url, 2)  # The bot-check is later
     sb.type(input_field, "github.com/seleniumbase/SeleniumBase")
     sb.reconnect(0.1)
     sb.uc_click(submit_button, reconnect_time=4)
+    sb.uc_gui_click_captcha()
     sb.wait_for_text_not_visible("Checking", timeout=10)
     sb.highlight('p:contains("github.com/seleniumbase/SeleniumBase")')
     sb.highlight('a:contains("Top 100 backlinks")')
@@ -109,13 +111,9 @@ from seleniumbase import SB
 
 with SB(uc=True, test=True, ad_block=True) as sb:
     url = "https://www.thaiticketmajor.com/concert/"
-    sb.uc_open_with_reconnect(url, 5.5)
-    sb.uc_click("button.btn-signin", 4)
-    sb.switch_to_frame('iframe[title*="Cloudflare"]')
-    sb.assert_element("div#success svg#success-icon")
-    sb.switch_to_default_content()
-    sb.set_messenger_theme(location="top_center")
-    sb.post_message("SeleniumBase wasn't detected!")
+    sb.uc_open_with_reconnect(url, 6.111)
+    sb.uc_click("button.btn-signin", 4.1)
+    sb.uc_gui_click_captcha()
 ```
 
 <img src="https://seleniumbase.github.io/other/ttm_bypass.png" title="SeleniumBase" width="540">
@@ -235,7 +233,7 @@ driver.reconnect("breakpoint")
 
 (Note that while the special <b><code translate="no">UC Mode</code></b> breakpoint is active, you can't use <b><code translate="no">Selenium</code></b> commands in the browser, and the browser can't detect <b><code translate="no">Selenium</code></b>.)
 
-👤 On Linux, you may need to use `driver.uc_gui_click_cf()` to successfully bypass a Cloudflare CAPTCHA. If there's more than one iframe on that website (and Cloudflare isn't the first one) then put the CSS Selector of that iframe as the first arg to `driver.uc_gui_click_cf()`. This method uses `pyautogui`. In order for `pyautogui` to focus on the correct element, use `xvfb=True` / `--xvfb` to activate a special virtual display on Linux.
+👤 On Linux, you may need to use `driver.uc_gui_click_cf()` to successfully bypass a Cloudflare CAPTCHA. If there's more than one Cloudflare iframe on that website, then put the CSS Selector of an element that's above the iframe as the first arg to `driver.uc_gui_click_cf()`. This method uses `pyautogui`. In order for `pyautogui` to focus on the correct element, use `xvfb=True` / `--xvfb` to activate a special virtual display on Linux.
 
 👤 `driver.uc_gui_click_cf(frame="iframe", retry=False, blind=False)` has three args. (All optional). The first one, `frame`, lets you specify the iframe in case the CAPTCHA is not located in the first iframe on the page. The second one, `retry`, lets you retry the click after reloading the page if the first one didn't work (and a CAPTCHA is still present after the page reload). The third arg, `blind`, will retry after a page reload (if the first click failed) by clicking at the last known coordinates of the CAPTCHA checkbox without confirming first with Selenium that a CAPTCHA is still on the page.
 
@@ -334,6 +332,16 @@ The above JS method is used within the <b><code translate="no">SeleniumBase</cod
 
 --------
 
+🛠️ <b>Troubleshooting UC Mode</b>
+
+On Windows, the `uc_gui_click_cf()` and `uc_gui_click_captcha()` methods require "Scaling" to be set at "100%". (Note that "100%" may be different from the system's "Recommended" percent, which can be higher depending on your screen resolution and monitor size.)
+
+<img src="https://seleniumbase.github.io/other/ts_uc_1.jpg" title="Make sure Scaling is set to 100%" width="410">
+
+As an alternative to using the `uc_gui_click_cf()` or `uc_gui_click_captcha()` methods on Windows, you can use `sb.uc_gui_handle_cf()`, which does not require "Scaling" to be set to a specific value. Instead of using the mouse to click a CAPTCHA, `sb.uc_gui_handle_cf()` uses a combination of the `TAB` key and the `SPACEBAR`.
+
+--------
+
 🏆 <b>Choosing the right CAPTCHA service</b> for your business / website:
 
 <img src="https://seleniumbase.github.io/other/me_se_conf.jpg" title="SeleniumBase" width="370">