From 9f017e834ca331141792c1143be323fd146852ef Mon Sep 17 00:00:00 2001
From: Ivan Molodetskikh <yalterz@gmail.com>
Date: Sun, 15 Dec 2024 16:44:05 +0300
Subject: wiki: Document new floating window rule and gesture

---
 wiki/Configuration:-Window-Rules.md | 25 +++++++++++++++++++++++++
 wiki/Gestures.md                    |  2 ++
 2 files changed, 27 insertions(+)

diff --git a/wiki/Configuration:-Window-Rules.md b/wiki/Configuration:-Window-Rules.md
index 18b4e4e2..b34d0469 100644
--- a/wiki/Configuration:-Window-Rules.md
+++ b/wiki/Configuration:-Window-Rules.md
@@ -41,6 +41,7 @@ window-rule {
     open-on-workspace "chat"
     open-maximized true
     open-fullscreen true
+    open-floating true
 
     // Properties that apply continuously.
     draw-border-with-background false
@@ -313,6 +314,30 @@ window-rule {
 }
 ```
 
+#### `open-floating`
+
+<sup>Since: next release</sup>
+
+Make the window open in the floating layout.
+
+```kdl
+// Open the Firefox picture-in-picture window as floating.
+window-rule {
+    match app-id=r#"^org\.mozilla\.firefox$"# title="^Picture-in-Picture$"
+
+    open-floating true
+}
+```
+
+You can also set this to `false` to *prevent* a window from opening in the floating layout.
+
+```kdl
+// Open all windows in the tiling layout, overriding any auto-floating logic.
+window-rule {
+    open-floating false
+}
+```
+
 ### Dynamic Properties
 
 These properties apply continuously to open windows.
diff --git a/wiki/Gestures.md b/wiki/Gestures.md
index b308a936..d82955dd 100644
--- a/wiki/Gestures.md
+++ b/wiki/Gestures.md
@@ -12,6 +12,8 @@ You can move windows by holding <kbd>Mod</kbd> and the left mouse button.
 
 You can customize the look of the window insertion preview in the `insert-hint` [layout config](./Configuration:-Layout.md) section.
 
+<sup>Since: next release</sup> Right click while moving to toggle between floating and tiling layout to put the window into.
+
 #### Interactive Resize
 
 <sup>Since: 0.1.6</sup>
-- 
cgit