fix(user): Split talk user documentation into pieces

user_manual/talk/appearance.rst

@@ -0,0 +1,22 @@
+==========
+Appearance
+==========
+
+Compact view of conversations list
+----------------------------------
+
+Compact view allows to hide last message preview in the conversation list, providing a more focused interface.
+
+.. image:: images/talk-compact-view.png
+   :width: 200px
+
+Chat messages
+-------------
+
+Chat appearance settings allow you to customize the look of your conversation chats.
+You can choose between classic list or message bubbles, with your own messages on the side.
+
+You can change both settings from the ``Talk settings`` dialog  in ``Appearance`` section.
+
+.. image:: images/talk-appearance-settings.png
+   :width: 600px

user_manual/talk/attachments.rst

@@ -0,0 +1,67 @@
+===========
+Attachments
+===========
+
+Sharing files in a chat
+-----------------------
+
+You can share files in a chat in 3 ways.
+
+First, you can simply drag'n'drop them on the chat.
+
+.. image:: images/drag-and-drop.png
+   :width: 600px
+
+Second, you can select a file from your Nextcloud Files or a file manager by choosing the little paperclip and selecting where you'd like to pick the file from.
+
+.. image:: images/share-files-in-chat.png
+   :width: 500px
+
+.. image:: images/share-files-in-chat-selection.png
+    :width: 600px
+
+You can add more files until you are done and decide to share the files. You can also add a text caption to your shared files, providing a brief description or context.
+
+.. image:: images/talk-upload-files.png
+   :width: 500px
+
+All users will be able to click the files to view, edit or download them, irrespective of them having a user account. Users with an account will have the file automatically shared with them while external guest users will get them shared as a public link.
+
+.. image:: images/editing-document-in-chat-room.png
+   :width: 600px
+
+Polls in chat
+-------------
+
+You can create a poll in groups chats from the new message additional actions.
+
+.. image:: images/create-new-poll.png
+   :width: 400px
+
+A poll has two settings:
+
+- **Anonymous polls**: Participants cannot see who voted for which option.
+- **Allow multiple choices**: Participants can select more than one option.
+
+You can also import polls for auto-fill and export polls as JSON files to save it locally.
+
+.. image:: images/import-poll.png
+   :width: 400px
+
+Closing poll is possible from the poll dialog.
+
+.. image:: images/close-poll.png
+   :width: 400px
+
+As a moderator, you can create the poll directly or you can save it as a draft to edit it later. 
+
+.. image:: images/save-poll-draft.png
+   :width: 400px
+
+You can find poll drafts in ``Shared items`` tab or next to the poll title input field.
+
+.. image:: images/poll-drafts-list.png
+   :width: 400px
+
+
+.. FIXME voice messages?, shared items view

user_manual/talk/bots.rst

@@ -0,0 +1,22 @@
+:orphan:
+
+Bots
+====
+
+.. FIXME Replace with bots as commands are removed, or remove?
+
+Commands
+--------
+
+Nextcloud allows users to execute actions using commands. A command typically looks like:
+
+    ``/wiki airplanes``
+
+Administrators can configure, enable and disable commands. Users can use the ``help`` command to find out what commands are available.
+
+    ``/help``
+
+.. image:: images/command-help.png
+    :width: 600px
+
+Find more information in the `administrative documentation for Talk. <https://nextcloud-talk.readthedocs.io/en/stable/commands/>`_

user_manual/talk/breakout_rooms.rst

@@ -0,0 +1,51 @@
+Breakout rooms
+==============
+
+Breakout rooms allow you to divide a Nextcloud Talk call into smaller groups for more focused discussions. The moderator
+of the call can create multiple breakout rooms and assign participants to each room.
+
+.. note:: Breakout rooms are currently not available in conversations that are joinable by guests (public conversations).
+
+Configure breakout rooms
+------------------------
+
+To create breakout rooms, you need to be a moderator in a group conversation. Click on the top-bar menu and click on
+"Setup breakout rooms".
+
+.. image:: images/talk-breakout-rooms-setup.png
+    :width: 400px
+
+A dialog will open where you can specify the number of rooms you want to create and the participants assignment method.
+Here you'll be presented with 3 options:
+
+- **Automatically assign participants**: Talk will automatically assign participants to the rooms.
+- **Manually assign participants**: You'll go through a participants editor where you can assign participants to rooms.
+- **Allow participants choose**: Participants will be able to join breakout rooms themselves.
+
+.. image:: images/talk-breakout-rooms-setup-dialog.png
+    :width: 500px
+
+Manage breakout rooms
+---------------------
+
+Once the breakout rooms are created, you will be able to see them in the sidebar.
+
+.. image:: images/talk-breakout-rooms-sidebar.png
+    :width: 500px
+
+From the sidebar header
+
+- **Start and stop the breakout rooms**: this will move all the users in the parent conversation to their respective breakout rooms.
+- **Broadcast a message to all the rooms**: this will send a message to all the rooms at the same time.
+- **Make changes to the assigned participants**: this will open the participants editor where you can change which participants are assigned to which breakout room. From this dialog it's also possible to delete the breakout rooms.
+
+.. image:: images/talk-breakout-rooms-sidebar-header.png
+    :width: 400px
+
+From the breakout room element in the sidebar, you can also join a particular breakout room or send a message to a
+specific room.
+
+.. image:: images/talk-breakout-rooms-sidebar-item.png
+    :width: 400px
+
+.. FIXME Ask for assistance, demo "free selection for a user"

user_manual/talk/calendar_integration.rst

@@ -0,0 +1,33 @@
+Calendar integration with Talk
+==============================
+
+Meetings and events
+--------------------
+
+If calendar events have a Talk conversation set as event location, you will see an information about upcoming events inside of this conversation.
+That way you can stay informed about scheduled meetings or activities directly within your chat.
+If Calendar app is enabled, you can click on an event to view details.
+
+.. image:: images/events-upcoming.png
+    :width: 500px
+
+It is possible to schedule a meeting directly from a conversation. In the dialog, you can set meeting details such as title, date, time and description.
+You can also choose to invite all participants including email guests, or select specific ones.
+
+.. image:: images/talk-schedule-meeting.png
+   :width: 500px
+
+Schedule from Calendar
+^^^^^^^^^^^^^^^^^^^^^^
+
+When creating a new event in Calendar, you can set a Talk conversation as event location. This will create a new conversation if one does not exist yet.
+
+.. image:: images/calendar-create-event.png
+   :width: 600px
+
+When the event is created, you will see a link to the conversation in the event details. Conversation will also show up in the list of conversations (discoverable by ``Events`` filter).
+
+.. image:: images/event-conversation-list.png
+   :width: 300px
+
+Like instant meetings, event conversations will be automatically deleted after configured period of inactivity (by default 28 days).

user_manual/talk/call.rst

@@ -0,0 +1,114 @@
+====
+Call
+====
+
+Starting a call
+---------------
+
+When you're in a conversation, you can start a call any time with the ``Start call`` button. Other participants will get notified and can join the call.
+
+.. image:: images/device-settings-before-call.png
+    :width: 600px
+
+If somebody else has started a call already, the button will change in a green ``Join call`` button.
+
+.. image:: images/join-call.png
+    :width: 600px
+
+During a call, you can mute your microphone and disable your video with the buttons on the right side of the top bar, or using the shortcuts ``M`` to mute audio and ``V`` to disable video. You can also use the space bar to toggle mute. When you are muted, pressing space will unmute you so you can speak until you let go of the space bar. If you are unmuted, pressing space will mute you until you let go.
+
+You can hide your video (useful during a screen share) with the little arrow just above the video stream. Bring it back with the little arrow again.
+
+You can access your settings and choose a different webcam, microphone and other settings in the ``...`` menu in the top bar.
+
+.. image:: images/media-settings.png
+    :width: 300px
+
+From media settings dialog, you can also change the background of your video.
+
+.. image:: images/background-settings-in-call.png
+    :width: 500px
+
+All these settings are also available as direct actions in the bottom bar.
+
+.. image:: images/call-bottom-bar.png
+    :width: 300px
+
+You can change other settings in the ``Talk settings`` dialog.
+
+.. image:: images/talk-settings.png
+    :width: 600px
+
+Starting a screen share
+-----------------------
+
+You can click the monitor icon on your video stream to share your screen. Depending on your browser, you will get the option to share a monitor, an application window or a single browser tab.
+If video from your camera is also available, other participants will see it in a small presenter view next to the screen share.
+
+.. image:: images/share-screen-with-camera.png
+    :width: 700px
+
+You can zoom in and out of the shared screen with mouse wheel, double click or touchpad gestures.
+
+Changing view in a call
+-----------------------
+
+You can switch the view in a call in the bottom bar between promoted view and grid view. 
+
+.. image:: images/call-view-toggle-button.png
+    :width: 300px
+
+The grid view will show as many people as the screen can fit, allowing navigation with buttons on the left and right.
+
+.. image:: images/talk-grid-view.png
+    :width: 700px
+
+The promoted view shows the speaker large and others in a row below. If the people do not fit on the screen, buttons will appear on the left and right that let you navigate.
+
+.. image:: images/talk-promoted-view.png
+    :width: 700px
+
+Download call participants list
+-------------------------------
+
+You can download the list of participants in a call from the ``...`` menu in the top bar. This will download a CSV file with the names and email addresses of all participants in the call.
+
+.. image:: images/download-participants-list.png
+   :width: 400px
+
+The table in the CSV file contains the following columns:
+
+- **Name**: The name of the participant.
+- **Email**: The email address of the participant.
+- **Type**: Indicates whether the participant is a registered user or a guest.
+- **Identifier**: Unique identifier for the participant.
+
+Call live transcription
+-----------------------
+
+Call live transcription allows to transcribe the speech in real-time during a call. It is set up by the system administration (High-performance backend and `Live Transcription App <https://apps.nextcloud.com/apps/live_transcription>`_ are required).
+Moderators need to set the language of the transcription in the conversation settings. All participants then can enable or disable the transcription for themselves in the call bottom bar.
+When enabled, the transcription will appear in the bottom and will be updated in real-time.
+
+.. image:: images/call-transcription.png
+   :width: 500px
+
+With `live_transcription` provider app enabled, you can also use live translation. Instead of receiving the transcription in the original message, it will be translated to the language of your choice.
+
+.. image:: images/call-translation-actions.png
+   :width: 400px
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

user_manual/talk/call_index.rst

@@ -0,0 +1,10 @@
+Calls
+=====
+
+.. toctree::
+   :maxdepth: 1
+
+   call
+   call_recording
+   webinar
+   breakout_rooms

user_manual/talk/call_recording.rst

@@ -0,0 +1,63 @@
+Call recording
+==============
+
+The recording feature provides users with an opportunity to:
+
+- Start and stop recordings during a call.
+- Record the video and audio stream of the speaker, as well as screen share.
+- Access, share and download recorded files for future reference or distribution.
+
+Enabling this feature requires the recording server to be set up by the system administration.
+
+Manage a recording
+------------------
+
+The moderator of the conversation can start a recording together with a call start or anytime during a call:
+
+- **Before the call**: tick the checkbox "Start recording immediately with the call" in "Media settings", then click on "Start call".
+- **During the call**: click on the top-bar menu, then click "Start recording".
+
+.. image:: images/start-recording-before-call.png
+    :width: 400px
+
+|
+
+.. image:: images/start-recording-in-call.png
+    :width: 300px
+
+The recording will start shortly, and you will see a red indicator next to the call time. You can stop the recording at any time while the call is still ongoing by clicking on that indicator and selecting "Stop recording", or by using the same action in the top-bar menu. If you do not manually stop the recording, it will end automatically when the call ends.
+
+.. image:: images/stop-recording.png
+    :width: 500px
+
+After stopping a recording, the server will take some time to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.
+
+.. image:: images/share-recording-notification.png
+    :width: 300px
+
+|
+
+.. image:: images/shared-recordings.png
+    :width: 400px
+
+Recording consent
+-----------------
+
+For compliance reasons with various privacy rights, it is possible to ask participants for consent to be recorded before joining the call. The system administration has the flexibility to utilize this feature in several ways:
+
+- Disable consent completely.
+- Enable mandatory consent system-wide, requiring consent for all conversations.
+- Allow moderators to configure this option on a conversation level. In such cases, moderators can access the conversation settings to configure this option accordingly:
+
+.. image:: images/enable-recording-consent.png
+    :width: 500px
+
+.. FIXME make screenshots below from user perspective not moderator
+
+If recording consent is enabled, every participant, including moderators, will see a highlighted section in the "Media settings" before joining a call.
+This section informs participants that the call may be recorded. To give explicit consent for recording, participants must check the box. If they do not give consent, they will not be allowed to join the call.
+
+.. image:: images/give-recording-consent-checked.png
+    :width: 500px
+
+.. FIXME add where they can be rewatched afterwards