Update

Author: ManuelSchneid3r

src/gettingstarted/faq.md

@@ -11,28 +11,25 @@ nav_order: 5
 {:toc}
 
 
-## Where are cache, config and data files stored?
+## Wayland
 
-According to [QStandardPaths](https://doc.qt.io/qt-6/qstandardpaths.html#StandardLocation-enum) base directories are:
+Wayland comes with a _lot_ of [limitations](https://gist.github.com/probonopd/9feb7c20257af5dd915e3a9f2d1f2277).
 
-|           | Linux/BSD                                                                                | MacOS                                                                                                                    |
-|-----------|------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|
-| Cache | 👨🏼‍💻 `~/.cache/albert`                                                                | 👨🏼‍💻 `~/Library/Caches/albert`<br>💻 `/Library/Caches/albert`                                                         |
-| Config | 👨🏼‍💻 `~/.config/albert`<br>💻 `/etc/xdg/albert`                                       | 👨🏼‍💻 `~/Library/Preferences/albert`                                                                                   |
-| Data      | 👨🏼‍💻 `~/.local/share/albert`<br>💻 `/usr/local/share/albert`<br>💻 `/usr/share/albert` | 👨🏼‍💻 `~/Library/Application Support/albert`<br>💻 `/Library/Application Support/albert`<br>💻 `<APPDIR>/../Resources` |
 
-Albert places its data in the base directories root.
-Plugins use subdirectories named by their identifier.
-In case of multiple directories the directories are considered in the given order. 
-Users may change the contents of the user 👨🏼‍💻 directories (manually or by using the app).
-Do not touch app/vendor 💻 directories!
+### XWayland
 
-{: .note}
-Note that environment variables may change these base directories on XDG platforms.
-See [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/latest/index.html) for more information.
-  
+Some of its limitations can be mitigated by using XWayland.
 
-## How to make hotkeys work on Wayland?
+```bash
+# Do not set QT_QPA_PLATFORM as it will propagate to launched apps
+albert --platform xcb
+```
+
+{: .note }
+Currently the shipped desktop entry does this for you.
+
+
+### Hotkeys
 
 Wayland hotkey adoption is still in its [infancy](https://dec05eba.com/2024/03/29/wayland-global-hotkeys-shortcut-is-mostly-useless/).
 A general solution is to let your desktop environment handle the hotkey registration.
@@ -63,26 +60,47 @@ echo -n '["toggle"]' | socat - ~/.cache/albert/ipc_socket
 Gnome does not invoke a shell for bindings. Use ```sh -c "<command line>"```.
 
 
+### Window rules
+
+Wayland does not allow to set window properties like on any other platforms.
+There some of the window settings have no effect.
+Some compositors allow configuring the window properties in their settings.
+
+- [KDE](https://docs.kde.org/stable5/en/kwin/kcontrol/windowspecific/index.html)
+- On Gnome your best bet is probably [GNOME Window Rules extension](https://help.gnome.org/users/gnome-help/stable/windows-properties.html.en).
+
 ## How to open with a particular text?
 
 ```bash
 albert show "trigger "
 ```
 
+## Where are cache, config and data files stored?
 
-## How to avoid Wayland and use XCB platform? 
+According to [QStandardPaths](https://doc.qt.io/qt-6/qstandardpaths.html#StandardLocation-enum) base directories are:
 
-```bash
-# Do not set QT_QPA_PLATFORM as it will propagate to launched apps
-albert --platform xcb
-```
+|           | Linux/BSD                                                                                | MacOS                                                                                                                    |
+|-----------|------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|
+| Cache | 👨🏼‍💻 `~/.cache/albert`                                                                | 👨🏼‍💻 `~/Library/Caches/albert`<br>💻 `/Library/Caches/albert`                                                         |
+| Config | 👨🏼‍💻 `~/.config/albert`<br>💻 `/etc/xdg/albert`                                       | 👨🏼‍💻 `~/Library/Preferences/albert`                                                                                   |
+| Data      | 👨🏼‍💻 `~/.local/share/albert`<br>💻 `/usr/local/share/albert`<br>💻 `/usr/share/albert` | 👨🏼‍💻 `~/Library/Application Support/albert`<br>💻 `/Library/Application Support/albert`<br>💻 `<APPDIR>/../Resources` |
 
-{: .note }
-Currently the shipped desktop entry does this for you.
+Albert places its data in the base directories root.
+Plugins use subdirectories named by their identifier.
+In case of multiple directories the directories are considered in the given order. 
+Users may change the contents of the user 👨🏼‍💻 directories (manually or by using the app).
+Do not touch app/vendor 💻 directories!
 
+{: .note}
+Note that environment variables may change these base directories on XDG platforms.
+See [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/latest/index.html) for more information.
+  
 
 ## How to get GNOME platform integration (auto dark mode)?
 
+{: .note }
+Since Qt6.4 automatic dark mode should at least work as expected for the main window.
+
 Install [QGnomePlatform](https://github.com/FedoraQt/QGnomePlatform).
 QGnomePlatform project is unmaintained and no longer actively developed, however there is nothing else providing that good integration (afaik).
 Note that QGnomePlatform sets styles and such (read [more](https://jgrulich.cz/2023/03/08/explained-qgnomeplatform-and-adwaita-qt/#QGnomePlatform)).