wiki: Document new floating window rule and gesture

2 files changed, 27 insertions, 0 deletions

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>