add: gtk3 ts popover example

closes #224
closes #157

2 files changed, 12 insertions, 4 deletions

diff --git a/docs/guide/typescript/examples.md b/docs/guide/typescript/examples.md
index ec51e89..ff1d9a1 100644
--- a/docs/guide/typescript/examples.md
+++ b/docs/guide/typescript/examples.md
@@ -2,13 +2,13 @@
 
 ## Gtk3
 
-### [Simple Bar](https://github.com/Aylur/astal/tree/main/examples/js/simple-bar)
+### [Simple Bar](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/simple-bar)
 ![simple-bar](https://github.com/user-attachments/assets/a306c864-56b7-44c4-8820-81f424f32b9b)
 
-### [Notification Popups](https://github.com/Aylur/astal/tree/main/examples/js/notifications)
+### [Notification Popups](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/notifications)
 ![notification-popups](https://github.com/user-attachments/assets/0df0eddc-5c74-4af0-a694-48dc8ec6bb44)
-### [Applauncher](https://github.com/Aylur/astal/tree/main/examples/js/applauncher)
+### [Applauncher](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/applauncher)
 ![launcher](https://github.com/user-attachments/assets/2695e3bb-dff4-478a-b392-279fe638bfd3)
 
-### [Media Player](https://github.com/Aylur/astal/tree/main/examples/js/media-player)
+### [Media Player](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/media-player)
 ![media-player](https://github.com/user-attachments/assets/891e9706-74db-4505-bd83-c3628d7b4fd0)
diff --git a/docs/guide/typescript/faq.md b/docs/guide/typescript/faq.md
index 132900a..15a97e5 100644
--- a/docs/guide/typescript/faq.md
+++ b/docs/guide/typescript/faq.md
@@ -299,3 +299,11 @@ focusable set its keymode.
 />
 ```
 :::
+
+## How to create a Popup
+
+In Gtk4 simply use Gtk's builtin [Popover](https://docs.gtk.org/gtk4/class.Popover.html).
+
+In Gtk3 you can create an [Astal.Window](https://aylur.github.io/libastal/astal3/class.Window.html) and handle click events.
+
+Checkout [examples/gtk3/js/popover](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/popover)