# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1696454226 -7200
# Node ID 4d45bed01183e2eb68c99854dcb0bcaacab1bbd5
# Parent  966c641d6c00f336f9fd358c5d41c26d158f77fa
doc: add forgotten file:

fix 424

diff -r 966c641d6c00 -r 4d45bed01183 doc/calls.rst
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/calls.rst	Wed Oct 04 23:17:06 2023 +0200
@@ -0,0 +1,62 @@
+=================
+Audio/Video Calls
+=================
+
+Libervia's Kivy desktop application offers a one-to-one audio and video call feature. This guide provides a step-by-step approach to utilizing this functionality.
+
+Accessing the Call Feature
+--------------------------
+
+1. Navigate to the main menu.
+2. Look for the widget with a phone icon and select it to access the "Call" feature.
+
+Initiating a Call
+-----------------
+
+When you're in the "Call" widget:
+
+1. You will notice a search bar located at the top.
+2. To make a call:
+
+ a. Type the full address (similar to an email address) of the person you wish to call into the search bar.
+ b. Click the "Call" button situated next to the search bar to initiate the call.
+
+*Note:* As development progresses, the interface may provide more intuitive ways to initiate calls.
+
+Receiving a Call
+----------------
+
+*For the time being, ensure you are in the "Call" widget to receive an incoming call. This will change in upcoming versions.*
+
+Upon receiving a call:
+
+1. The call is automatically accepted.
+2. If it's a video call, you will see the video of the person calling. Additionally, a smaller video feed in the bottom right corner shows what you are transmitting.
+
+During a Call
+-------------
+
+While you are on a call:
+
+1. **End Call:** To conclude the call, you can click the "Hang Up" button
+
+Security and Privacy Aspects of Calls
+-------------------------------------
+
+It's crucial to stay aware of what information you share and prioritize your privacy:
+
+**1. Sharing Your "Online Presence" and Address:**
+
+ Engaging in a call shares your unique online address (akin to a phone number), indicating you're online and active. It's like turning the lights on at home, letting others know you're present.
+
+**2. Privacy Implications:**
+
+ Although it's common to share this information with trusted contacts, unfamiliar users may infer your activity patterns and general vicinity.
+
+**3. Safety Recommendations:**
+
+ - **Be Selective:** Make or accept calls only with those you trust.
+ - **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.