docs: clarify v2.3 beta feature availability

Author: kungaa

README.md

@@ -24,6 +24,13 @@ getting it right on Linux / SteamOS (Bazzite).
 
 ## Core Features
 
+> **v2.3 beta availability:** Features labeled **v2.3 beta** below are currently
+> available only in the latest pre-release. Download it from
+> [Releases](../../releases), or enable **Include pre-releases** on the config
+> page's Update tab before installing over WiFi. The **BETA** label on the
+> existing multi-controller and OTA features describes their maturity; both
+> are also included in the stable v2.2.1 release.
+
 - 🎮 **Full wireless controller emulation** — DualSense Bluetooth reports → standard
   USB HID gamepad at up to 1000 Hz. Supports DualSense (DS5) and DualSense Edge
   (DSE), including DSE PS-app profiles.
@@ -32,40 +39,40 @@ getting it right on Linux / SteamOS (Bazzite).
   by default (a web-page toggle enables it; the default behavior is unchanged
   single-controller). Audio and HD haptics are single-controller features (not
   enough Bluetooth airtime beside a second pad); classic rumble and adaptive
-  triggers work for everyone. *Currently only in pre-release builds — grab the
-  latest pre-release from [Releases](../../releases).* See the
+  triggers work for everyone. **v2.3 beta:** a config-page action can power off
+  all connected pads without forgetting their pairings. See the
   [user guide](docs/USER_GUIDE.md#using-multiple-controllers-at-once).
 - 📳 **Wireless HD haptics** — recreates the cabled audio-based haptic feedback over
   Bluetooth, streaming the dedicated haptic waveforms to the controller's
   voice-coil actuators. Compatibility mirrors the wired experience.
 - 🔊 **Wireless audio (speaker + mic)** — speaker/headphone playback and microphone
   upload over standard USB Audio Class — full quality, no Bluetooth headset-profile
-  (HSP) downgrade. Controller microphone upload is disabled while no host
-  application has the microphone stream open.
-- 🔇 **Layered hardware mic mute** — driverless local mute via the physical Mute
-  button and host sound-panel mute remain independent, so releasing either
-  cannot override the other. The orange LED follows the effective mute state,
-  while active host drivers (e.g. Linux `hid-playstation`) retain ownership.
-- 🌐 **Web config over WPA2 or WPA3 WiFi + bond management** — the adapter joins
+  (HSP) downgrade. **v2.3 beta:** controller microphone upload is disabled while
+  no host application has the microphone stream open.
+- 🔇 **Layered hardware mic mute — v2.3 BETA** — driverless local mute via the
+  physical Mute button and host sound-panel mute remain independent, so
+  releasing either cannot override the other. The orange LED follows the
+  effective mute state, while active host drivers (e.g. Linux
+  `hid-playstation`) retain ownership.
+- 🌐 **Web config over WiFi + bond management** — the adapter joins
   your home WiFi and hosts its own configuration page at **http://ds5.local/**
   (no app, no WebHID, any browser). First-run setup is a phone-friendly captive
-  portal with explicit WPA3-only hotspot/network support.
-  Adjust settings and manage remembered controllers, connected or not. If the
-  saved network is unavailable, gameplay continues offline while WiFi retries.
-  Three consecutive authentication failures reopen onboarding automatically;
-  for other failures, power controllers off and click BOOTSEL three times to
-  reopen it without erasing the old network.
+  portal. Adjust settings and manage remembered controllers, connected or not.
+- 📶 **WPA3 and resilient WiFi recovery — v2.3 BETA** — onboarding supports an
+  explicit WPA3-only choice. If the saved network is unavailable, gameplay
+  continues offline while WiFi retries. Three consecutive authentication
+  failures reopen onboarding automatically; for other failures, power
+  controllers off and click BOOTSEL three times to reopen it without erasing
+  the old network.
 - 🎮 **Decky Loader companion plugin** — a [Decky Loader plugin](https://github.com/kungaa/DS5-Linux-Decky)
   surfaces controller status and settings in the Quick Access Menu, talking to
   the same on-device API as the web page.
 - ⬆️ **Over-the-air updates — BETA** — one click on the config page installs the
   latest GitHub release over HTTPS (pinned CA roots, SHA-256-verified against
   the release manifest) with no PC involved. The download is staged in spare
   flash, so a failed/interrupted download changes nothing. Pico 2 W and
-  Waveshare boards; the Pico W's 2 MB flash is too small. *Currently only in
-  pre-release builds — grab the latest pre-release from
-  [Releases](../../releases) and tick "include pre-releases" in the Update
-  tab.* See the [user guide](docs/USER_GUIDE.md#updating-over-wifi-ota).
+  Waveshare boards; the Pico W's 2 MB flash is too small. See the
+  [user guide](docs/USER_GUIDE.md#updating-over-wifi-ota).
 - 🖥️ **Wake-on-LAN** — press the controller's PS button to wake a sleeping or
   fully-off PC (even S4/S5) by sending a magic packet over WiFi. Wakes up to two
   targets (e.g. your PC and a TV), with a one-click "Find MAC" helper.
@@ -79,8 +86,8 @@ getting it right on Linux / SteamOS (Bazzite).
 - 📡 **USB 3.0 RF-noise watchdog** — auto-retries Bluetooth connections stalled by
   2.4 GHz interference from USB 3.0 ports (USB 2.0 ports recommended).
 - 🚨 **Visual notifications** — POST LED pattern, solid LED on a live link, a
-  once-per-second low-battery blink (≤10%), and a continuous 2 Hz blink during
-  WiFi onboarding.
+  once-per-second low-battery blink (≤10%), and, in **v2.3 beta**, a continuous
+  2 Hz blink during WiFi onboarding.
 
 📖 **See the [User Guide](docs/USER_GUIDE.md)** for flashing, pairing, the config
 page, and OS-specific (Linux / Windows) behavior and troubleshooting.
@@ -93,19 +100,19 @@ page, and OS-specific (Linux / Windows) behavior and troubleshooting.
    `.uf2` onto the mounted `RP2350` volume.
 2. **Onboard WiFi** — the first time, the adapter opens a setup network named
    **`DS5-Setup-XXXX`**. Join it from your phone or laptop, browse to
-   **http://10.55.55.105/**, pick your home WiFi, choose WPA3-only if the
-   router/hotspot requires it, and enter its password. The adapter reboots and
-   joins your network.
+   **http://10.55.55.105/**, pick your home WiFi, and enter its password.
+   **v2.3 beta** also offers a WPA3-only choice for networks that require it.
+   The adapter reboots and joins your network.
 3. **Pair** — put the DualSense in pairing mode (hold **Share + PS** until the
    lightbar double-blinks). The adapter detects, pairs, and connects; the onboard
    LED goes solid.
 4. **Configure** *(optional)* — once on your WiFi, browse to **http://ds5.local/**
    to change settings, set up Wake by USB or Wake-on-LAN, and manage paired controllers.
 
-If the saved WiFi is unavailable later, controller operation continues normally.
-To change networks, power off every controller and press and release the Pico's
-**BOOTSEL** button three times within four seconds; the setup network reopens
-for one boot.
+**v2.3 beta:** if the saved WiFi is unavailable later, controller operation
+continues normally while WiFi retries. To change networks, power off every
+controller and press and release the Pico's **BOOTSEL** button three times
+within four seconds; the setup network reopens for one boot.
 
 Full details, including onboarding, Wake-on-LAN, adding a second controller, and
 per-OS audio notes, are in the **[User Guide](docs/USER_GUIDE.md)**.

docs/USER_GUIDE.md

@@ -4,6 +4,12 @@ Operational manual for the firmware: flashing, WiFi setup, pairing, the config
 page, Wake-on-LAN, and OS-specific (Linux / Windows) behavior. For building from
 source and debugging, see the [README](../README.md).
 
+> **v2.3 beta availability:** Callouts marked **v2.3 beta** describe features
+> currently available only in the latest pre-release. Download it from
+> [Releases](https://github.com/kungaa/DS5-Linux-Bridge/releases), or enable
+> **Include pre-releases** on the config page's Update tab before installing
+> over WiFi.
+
 - [Flashing the firmware](#flashing-the-firmware)
 - [First-time WiFi setup](#first-time-wifi-setup)
 - [Pairing a controller](#pairing-a-controller)
@@ -45,6 +51,9 @@ project's GitHub Releases:
    (downloading / verifying / installing).
 3. Settings, WiFi credentials and paired controllers are all kept.
 
+To install the v2.3 beta rather than the latest stable release, enable
+**Include pre-releases** before clicking **Install latest**.
+
 Safety properties worth knowing:
 
 * The download goes to a spare region of flash; the running firmware is not
@@ -68,6 +77,10 @@ Safety properties worth knowing:
 The adapter serves its config page and sends Wake-on-LAN over your home WiFi, so
 the first time you run it you tell it which network to join.
 
+> **v2.3 beta:** The WPA3 selection, background retry policy, automatic
+> authentication-failure recovery, BOOTSEL recovery gesture, and 2 Hz
+> onboarding indicator described below require the latest v2.3 pre-release.
+
 1. On first boot (with no WiFi saved) the adapter starts its own open setup
    network named **`DS5-Setup-XXXX`** (the `XXXX` is unique per adapter).
 2. Join it from a phone or laptop and browse to **http://10.55.55.105/**.
@@ -187,10 +200,10 @@ What to expect:
 - **Getting audio / HD haptics back:** the adapter stays in multi-controller
   mode as long as *any* controller from the group is connected, so nobody's
   game is interrupted when others leave. To return to the full
-  single-controller experience (audio, mic, HD haptics), use **Power off all
-  controllers** on the config page's Controller tab, then reconnect one. The
-  red button appears while two or more controllers are connected. It keeps all
-  controller pairings.
+  single-controller experience (audio, mic, HD haptics), power all controllers
+  off, then reconnect one. **v2.3 beta:** the config page's Controller tab
+  provides a red **Power off all controllers** button while two or more are
+  connected. It keeps all controller pairings.
 - Turning the toggle back **off** mid-session doesn't disconnect anyone; it
   applies to new connections only (the next second controller is refused).
 
@@ -265,14 +278,15 @@ The **Network** tab has two things:
 - **Reset saved WiFi** — forgets the saved network and reboots into the
   `DS5-Setup-XXXX` onboarding mode so you can join a different WiFi.
 
-If the saved network is unavailable and this page cannot be reached, power off
-all controllers and press and release the Pico's **BOOTSEL** button three times
-within four seconds. The adapter reboots after the third release and enters the
-setup network for one boot. Its old WiFi credentials remain saved unless you
-submit replacements, and the onboard LED blinks continuously at 2 Hz while
-setup mode is active. If the network instead rejects authentication three times,
-the adapter automatically clears the rejected credentials and enters this setup
-mode; those authentication retries are five seconds apart.
+**v2.3 beta:** If the saved network is unavailable and this page cannot be
+reached, power off all controllers and press and release the Pico's **BOOTSEL**
+button three times within four seconds. The adapter reboots after the third
+release and enters the setup network for one boot. Its old WiFi credentials
+remain saved unless you submit replacements, and the onboard LED blinks
+continuously at 2 Hz while setup mode is active. If the network instead rejects
+authentication three times, the adapter automatically clears the rejected
+credentials and enters this setup mode; those authentication retries are five
+seconds apart.
 
 ---
 
@@ -353,15 +367,17 @@ without any extra firmware. See that repository for installation and usage.
 
 ### Windows 11
 
-- **Audio & layered mute.** Runs driverless. The physical Mute button and the
-  Windows Sound-panel mute are independent layers: if both are active, clearing
-  either one leaves the microphone muted until the other is also cleared. The
-  controller's orange LED and the actual microphone stream always follow that
-  combined state. Because the physical button is driverless, it does not move
-  the Windows checkmark; that checkmark represents only the Windows layer.
-- **Idle microphone transport.** When no application has the microphone stream
-  open, the adapter asks the controller to stop uploading Bluetooth microphone
-  frames. Opening a recorder or voice-chat application enables upload
-  automatically; ordinary muting keeps the open stream alive but silent.
+- **v2.3 beta — Audio & layered mute.** Runs driverless. The physical Mute
+  button and the Windows Sound-panel mute are independent layers: if both are
+  active, clearing either one leaves the microphone muted until the other is
+  also cleared. The controller's orange LED and the actual microphone stream
+  always follow that combined state. Because the physical button is
+  driverless, it does not move the Windows checkmark; that checkmark represents
+  only the Windows layer.
+- **v2.3 beta — Idle microphone transport.** When no application has the
+  microphone stream open, the adapter asks the controller to stop uploading
+  Bluetooth microphone frames. Opening a recorder or voice-chat application
+  enables upload automatically; ordinary muting keeps the open stream alive
+  but silent.
 - **HD haptics.** Work out of the box in titles that support them on a wired
   DualSense (e.g. Death Stranding Director's Cut).