--- a/doc/user/calls.rst	Mon Aug 14 16:49:02 2023 +0200
+++ b/doc/user/calls.rst	Mon Aug 14 16:54:13 2023 +0200
@@ -44,10 +44,17 @@
 2. **Mute Options:** Two buttons at the bottom of the interface enable you to mute your audio or video.
    - Muted audio: The audio icon will turn yellow with a red strike-through, indicating that your audio is off and the other party cannot hear you.
    - Muted video: The video icon will turn yellow with a red strike-through, signaling that your video is off and the other party cannot see you.
-3. **End Call:** Click the "Hang Up" button to conclude the call.
+3. **Screen Sharing (Desktop Only):** Next to the mute buttons is a desktop icon. By default, it is green and crossed out, indicating no screen sharing.
 
-Security Considerations for Calls
----------------------------------
+   - Click the icon to share your desktop or a specific window. The browser will prompt you to choose what you want to share.
+   - Once sharing, the icon turns red and the cross disappears, replacing the camera stream with your desktop or selected window.
+   - Click the icon again or use the browser dialog to stop sharing and revert to the camera stream.
+4. **End Call:** Click the "Hang Up" button to conclude the call.
+
+*Note:* The screen sharing feature is available only on desktop versions of browsers that support the functionality.
+
+Security Considerations for Calls and Screen Sharing
+----------------------------------------------------
 
 When using Libervia's call feature, it's essential to consider certain privacy aspects:
 
@@ -65,4 +72,15 @@
    - **Network Usage:** While the call feature is designed for use anywhere, including public networks like in restaurants or hotels, be mindful that unfamiliar networks might be less secure.
    - **Stay Informed:** If you have questions or concerns, you can join our community chat room for guidance. Visit `Libervia's Chat Room <xmpp:libervia@chat.jabberfr.org?join>`_.
 
+**4. Screen Sharing Implications:**
+
+   Sharing your desktop or a specific window offers another layer of accessibility to the person on the other side of the call. This means they can see everything displayed on the chosen screen, including personal files, notifications, and other sensitive information that might be accidentally displayed.
+
+**5. Safety Recommendations for Screen Sharing:**
+
+   - **Review Before Sharing:** Before starting a screen sharing session, close any unrelated applications or windows. Ensure no sensitive information, like passwords, private messages, or confidential documents, is visible.
+   - **Stay Aware:** During a screen sharing session, remember that everything on your screen is visible to the other party. Avoid accessing personal files or confidential information.
+   - **Use With Trusted Contacts:** As with audio and video calls, only use the screen sharing feature with individuals or groups you trust.
+   - **Understand Browser Permissions:** The browser will typically ask you which screen, application, or window you'd like to share. Ensure you're only sharing what's intended. If in doubt, choose to share a specific application or window rather than the entire screen.
+
 Always prioritize your privacy and be aware of the information you share while using the call feature.