docs: add GNOME Wayland setup and align desktop FAQs

src/components/LatestRelease.astro

@@ -151,14 +151,25 @@ const { downloadLinks, version, releaseDate } = await loadInitialData();
       />
     </div>
   )}
-  <p class="mt-4 max-w-sm">
-    Using KDE Plasma 6 on Wayland? Install the optional{' '}
-    <a class="gitify-download-link" href="https://store.kde.org/p/2371508/">
-      Gitify KWin script
-    </a>{' '}
-    to keep Gitify beside your panel.{' '}
-    <a class="gitify-download-link" href="/faq#kde-wayland-positioning">
-      Setup instructions
-    </a>
-  </p>
+  <aside
+    class="mt-4 max-w-sm text-xs text-gray-600"
+    aria-label="Optional Linux Wayland setup"
+  >
+    <p>
+      Linux on Wayland?{' '}
+      <a
+        class="hover:text-gray-900 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-gitify-button-rest"
+        href="/faq#gnome-wayland-positioning"
+      >
+        GNOME setup
+      </a>{' '}
+      <span aria-hidden="true">·</span>{' '}
+      <a
+        class="hover:text-gray-900 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-gitify-button-rest"
+        href="/faq#kde-wayland-positioning"
+      >
+        KDE Plasma setup
+      </a>
+    </p>
+  </aside>
 </div>

src/faqs/troubleshooting/gnome-wayland-positioning.md

@@ -0,0 +1,49 @@
+---
+title: "How do I keep Gitify beside the tray icon on GNOME?"
+category: "Troubleshooting"
+order: 5
+---
+On Wayland, the desktop controls window placement, so Gitify may open in the center of the screen. The optional [Gitify GNOME extension](https://extensions.gnome.org/extension/10968/gitify/) places its popup below its tray icon.
+
+### Requirements
+
+- **GNOME Shell 50 or 51** on a Wayland session.
+- **Gitify 7.8 or newer**, installed separately, with **Use X11 backend** off.
+- A tray provided by [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/), or a distribution that includes it, such as Ubuntu. GNOME Shell has no built-in tray.
+
+The extension is not needed on an X11 session or when Gitify's **Use X11 backend** setting is enabled.
+
+### Installation
+
+#### From GNOME Extensions
+
+1. Install and enable [AppIndicator support](https://extensions.gnome.org/extension/615/appindicator-support/) if your desktop does not already provide it.
+2. Install and enable [Gitify on GNOME Extensions](https://extensions.gnome.org/extension/10968/gitify/).
+3. Open the extension's settings in **GNOME Extensions** or **Extension Manager** and use **Set up Gitify** to check the app and tray setup.
+4. Open Gitify from its tray icon. Portable AppImages may need to be launched from your files first.
+
+The GNOME Extensions listing currently provides version **0.1.0 for GNOME Shell 50**. For GNOME Shell 51, use a release bundle whose metadata includes Shell 51 until a compatible version is published on the listing.
+
+#### From a release bundle
+
+Download `gitify@gitify.io.shell-extension.zip` from the [latest extension release](https://github.com/gitify-app/gnome/releases/latest), then run:
+
+```shell
+gnome-extensions install --force gitify@gitify.io.shell-extension.zip
+```
+
+GNOME Shell discovers new extensions at login on Wayland, so **log out and back in**, then enable the extension:
+
+```shell
+gnome-extensions enable gitify@gitify.io
+```
+
+If you use **Gitify 7.8.0** with the default dark GNOME panel, enable **Use white tray icon** in Gitify's Tray settings.
+
+### Window placement
+
+The extension places Gitify below its tray icon. If it cannot find the icon, it places the window in the top-right corner of the primary monitor instead.
+
+For current compatibility, source code, and issue reports, see [Gitify for GNOME on GitHub](https://github.com/gitify-app/gnome#install).
+
+Related: [KDE Plasma window positioning](#kde-wayland-positioning).

src/faqs/troubleshooting/kde-wayland-positioning.md

@@ -5,14 +5,25 @@ order: 4
 ---
 On Wayland, the desktop controls window placement, so Gitify may open in the center of the screen. The optional [Gitify KWin script on KDE Store](https://store.kde.org/p/2371508/) places its popup beside your panel when you open it from the tray.
 
-The script requires **KDE Plasma 6 on Wayland** and **Gitify 7.8 or newer**. Install Gitify separately and leave its **Use X11 backend** setting off.
+### Requirements
+
+- **KDE Plasma 6** on a Wayland session.
+- **Gitify 7.8 or newer**, installed separately, with **Use X11 backend** off.
+
+The script is not needed on an X11 session or when Gitify's **Use X11 backend** setting is enabled.
+
+### Installation
 
 1. Download `gitify.kwinscript` from the KDE Store listing.
 2. Open **System Settings → Window Management → KWin Scripts**.
 3. Choose **Install from File** and select the downloaded script.
 4. Enable **Gitify** and click **Apply**.
 5. Open Gitify from its tray icon.
 
+### Window placement
+
 The script remembers the last tray-click position for keyboard opens. Before the first tray click, it places Gitify near the end of the panel. It supports top, bottom, left, and right panels, including floating and auto-hide panels.
 
-For source code, positioning details, and issue reports, see [Gitify for KDE on GitHub](https://github.com/gitify-app/kde).
+For current compatibility, source code, and issue reports, see [Gitify for KDE on GitHub](https://github.com/gitify-app/kde).
+
+Related: [GNOME window positioning](#gnome-wayland-positioning).