--- a/doc/calls.rst	Thu Jan 18 23:31:29 2024 +0100
+++ b/doc/calls.rst	Thu Jan 18 23:46:31 2024 +0100
@@ -46,9 +46,13 @@
 
    a. Mute/unmute video: When muted, the video icon turns yellow with a red strike-through.
    b. Mute/unmute audio: When muted, the audio icon turns yellow with a red strike-through.
-   c. Desktop Sharing: A desktop icon to initiate screen sharing. By default, the icon is green with a strike-through, indicating no screen sharing. Clicking this icon opens a popup to select either full screen or a specific window for sharing. Once sharing, the icon turns red and the strike-through disappears. Click again to stop sharing.
+   c. Desktop Sharing: A desktop icon to initiate screen sharing. By default, the icon is green with a strike-through, indicating no screen sharing. For X11 systems, clicking this icon opens a popup to select either full screen or a specific window for sharing. In Wayland systems, instead of a popup, a screen sharing selection window (provided by the system's desktop environment) will be used to choose the monitor or window for sharing. Once sharing, the icon turns red and the strike-through disappears. Click again to stop sharing.
    d. Hang Up: A red phone icon in a horizontal direction to end the call.
 
+.. note::
+
+   For desktop sharing to work, your computer needs additional software: ``xdg-desktop-portal`` and a desktop-specific companion package (like ``xdg-desktop-portal-gtk`` for GNOME or ``xdg-desktop-portal-kde`` for KDE). These programs are usually provided through your operating system's software library. Check your system's help resources for guidance on installing these packages.
+
 Fullscreen Mode
 ---------------