From ac5c8b8ebb1841aee1874d95dd7f20590e0acb7b Mon Sep 17 00:00:00 2001
From: Jin Liu <m.liu.jin@gmail.com>
Date: Fri, 16 May 2025 00:28:18 +0800
Subject: [PATCH] doc/kitten/panel: add suggestion to set `--app-id=dock` for
 kwin

---
 docs/kittens/panel.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/kittens/panel.rst b/docs/kittens/panel.rst
index dee0953c1..773028a43 100644
--- a/docs/kittens/panel.rst
+++ b/docs/kittens/panel.rst
@@ -149,6 +149,11 @@ Compatibility with various platforms
         🟢 **KDE** (kwin)
            Fully working, no known issues
 
+           kwin uses an undocumented mapping <https://invent.kde.org/plasma/kwin/-/blob/3dc5cee6b34792486b343098e55e7f2b90dfcd00/src/layershellv1window.cpp#L24>
+           under Wayland to set the window type from the `--app-id` parameter. You might want to use
+           `--app-id=dock` so that kwin treats the window as a dock panel, and disables window
+           appearing/disappearing animations for it.
+
         🟠 **Sway**
            Partially working. Issues include:
                * Renders its configured background over the background window instead of