diff --git a/docs/site-example/site.conf b/docs/site-example/site.conf
index 150bef81..25902af4 100644
--- a/docs/site-example/site.conf
+++ b/docs/site-example/site.conf
@@ -47,7 +47,7 @@
       -- ssid = 'alpha-centauri.freifunk.net', (optional - SSID for open client network)
       -- disabled = true, -- (optional)
 
-      -- Configuration for a non-backward compatible OWE network below.
+      -- Configuration for a backward compatible OWE network below.
       -- owe_ssid = 'owe.alpha-centauri.freifunk.net', -- (optional - SSID for OWE client network)
       -- owe_transition_mode = true, -- (optional - enables transition-mode - requires ssid as well as owe_ssid)
     },
diff --git a/docs/user/site.rst b/docs/user/site.rst
index 7094cb83..8dc97f47 100644
--- a/docs/user/site.rst
+++ b/docs/user/site.rst
@@ -140,9 +140,15 @@ wifi24 \: optional
     For an OWE secured network, the ``owe_ssid`` string has to be set. It sets the
     SSID for the opportunistically encrypted wireless network, to which compatible
     clients can connect to.
+    For OWE to work, the ``wireless-encryption-wpa3`` has to be enabled (usually by
+    adding it to ``GLUON_FEATURES_standard``) in your ``site.mk``.
     To utilize the OWE transition mode, ``owe_transition_mode`` has to be set to true.
+    When ``owe_transition_mode`` is enabled, the OWE secured SSID will be hidden.
+    Compatible devices will automatically connect to the OWE secured SSID when selecting
+    the open SSID.
     Note that for the transition mode to work, both ``ssid`` as well as ``owe_ssid``
-    have to be enabled.
+    have to be enabled. Also, some devices with a broken implementation might not be able
+    to connect with a transition-mode enabled network.
 
     ``mesh`` requires a single parameter, a string, named ``id`` which sets the
     mesh id, also visible as an open WiFi in some network managers. Usually you