# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1705413623 -3600
# Node ID 290b405940b592abcbfb41da915a1d70a4931ad9
# Parent  97ab236e8f20d5151646788e00774a68411a1c5a
doc (calls): add desktop sharing documentation:

fix 433

diff -r 97ab236e8f20 -r 290b405940b5 doc/calls.rst
--- a/doc/calls.rst	Tue Jan 16 10:41:38 2024 +0100
+++ b/doc/calls.rst	Tue Jan 16 15:00:23 2024 +0100
@@ -42,11 +42,12 @@
 
    - An icon lets you toggle between fullscreen and the regular view.
 
-4. Below the video feeds, three buttons are available:
+4. Below the video feeds, four buttons are available:
 
    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. Hang Up: A red phone icon in a horizontal direction to end the call.
+   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.
+   d. Hang Up: A red phone icon in a horizontal direction to end the call.
 
 Fullscreen Mode
 ---------------
@@ -57,8 +58,8 @@
 2. The "Hang Up" button allows you to end the call and return to the regular view.
 3. Use the shortcut ``Alt+n`` to toggle the notification bar on or off. By default, it's hidden.
 
-Security Considerations for Calls
----------------------------------
+Security Considerations for Calls and Desktop Sharing
+-----------------------------------------------------
 
 When using Libervia's call feature, prioritize your privacy and safety:
 
@@ -70,10 +71,15 @@
 
  Although it's common to share this information with trusted contacts, unfamiliar users may infer your activity patterns and general vicinity.
 
-**3. Safety Recommendations:**
+**3. Screen Sharing Considerations:**
+
+ Sharing your desktop or a specific window during a call allows the other party to see everything on that screen. Be mindful of any sensitive information displayed.
 
- - **Be Selective:** Only make or receive calls from trusted individuals.
+**4. Safety Recommendations:**
+
+ - **Be Selective:** Only make or receive calls and share your screen with trusted individuals.
+ - **Review Before Sharing:** Ensure no sensitive information is visible on your screen before initiating screen sharing.
  - **Network Usage:** Though designed to function anywhere, remember that public networks (like those in coffee shops or hotels) might be less secure.
  - **Stay Informed:** For any queries or concerns, join our community chat room. You can find it at the provided link on our website.
 
-Remember to stay vigilant and make informed decisions while using the call feature. Regularly check for updates, as we continually work to enhance your experience.
+Remember to stay vigilant and make informed decisions while using the call and screen sharing features. Regularly check for updates, as we continually work to enhance your experience.