feat(talk): add user documentation for 35 features

user_manual/talk/attachments.rst

@@ -23,13 +23,27 @@ Second, you can select a file from your Nextcloud Files or a file manager by cho
     :alt: Talk file selection panel showing available files to share in chat
     :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.
+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. When you share several files at once, they are combined into a single message in the chat instead of one message per file, keeping the conversation easier to follow.
 
+.. TODO: needs a new screenshot showing several files combined into one message, current image is the old single-file upload queue
 .. image:: images/talk-upload-files.png
-   :alt: Talk file upload queue before sending files in chat
+   :alt: Talk file upload queue with several files combined into one message before sending
    :width: 500px
 
-All users will be able to click the files to view, edit or download them, regardless of whether they have a Nextcloud 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.
+Before you send the files, this staging area also lets you set options that apply to the upload. When you share
+images, they use ``Standard image quality`` by default, which resizes and compresses them to save bandwidth and
+storage; switch to ``Original image quality`` if you need to share the full-quality file. GIF, SVG and HEIC images
+are always sent in original quality. Depending on your instance, you can also choose ``View-only for others``
+(the default) or ``Editable by others`` for the shared files.
+
+If you delete a message with several files, all files of that message are deleted.
+
+.. TODO: feature is live in 25.0.0, needs a real screenshot of the compression and view-only/can-edit menus opened in the staging area
+.. image:: images/talk-upload-files.png
+   :alt: Talk staging area showing the image compression and view-only/can-edit options
+   :width: 500px
+
+All users will be able to click the files to view or download them, regardless of whether they have a Nextcloud account, and edit them if you allowed it. 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
    :alt: Talk chat with a shared document that participants can open and edit

user_manual/talk/call.rst

@@ -21,6 +21,7 @@ When a call is already in progress, join it by clicking the green ``Join call``
 
 You will see the ``Check devices`` dialog, where you can customise your call experience:
 
+.. TODO: update screenshot to show the notify all participants checkbox next to the Start call button
 .. image:: images/calls/media-settings-initial.png
     :alt: Talk Check devices dialog before joining a call
     :width: 600px
@@ -81,12 +82,28 @@ and whether you have ``Moderator`` permission for the conversation.
 If you are joining and the call is being recorded, you might be required to consent before being allowed to join.
 For more information, see :ref:`Call recording <call-recording>`.
 
+Restricting who can start a call (moderator)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+An administrator can limit who is allowed to start a call server-wide, to one of: everyone, users and moderators,
+moderators only, or nobody (calls disabled). An administrator can additionally restrict starting a call to
+members of specific groups; when such groups are configured, only their members can start a call, and this also
+applies to moderators, while guests and federated users can never be part of a group.
+
+If you are not allowed to start a call, the ``Start call`` button is disabled until somebody else starts the call.
+You can then join the call in progress. For conversations hosted on a federated server, the configuration of that
+server applies instead. Ask your administrator to check the Talk admin settings if you need to start calls yourself.
+
 Start the call
 ^^^^^^^^^^^^^^
 
 Click the ``Start call`` button at the bottom of the ``Check devices`` dialog to notify all conversation participants of the call.
-If you do not want to notify the other participants, start a silent call by opening the three-dot menu to the left of the ``Start call`` button
-and choosing ``Start call silently``.
+If you do not want to notify the other participants, start a silent call: clear the
+``Notify all participants about this call`` checkbox, then click ``Start call silently``.
+In the conversation top bar, open the ``More actions`` menu next to the ``Start call`` button and choose
+``Start call silently``.
+
+.. TODO: screenshots below show the old three-dot menu, replace them with the notify checkbox and the top bar menu
 
 .. image:: images/calls/media-settings-silent-call.png
     :alt: Talk Start call silently option in the Check devices dialog
@@ -173,6 +190,7 @@ Controlling audio and video
 
 Bottom bar of the call view offers media controls, layout settings and other features you can use during a call.
 
+.. TODO: update screenshot to show the new layout menu with multi-speaker view in the bottom bar
 .. image:: images/calls/during-a-call-controls.png
     :alt: Talk active call bottom bar showing media controls and layout settings
     :width: 400px

user_manual/talk/call_views.rst

@@ -2,10 +2,12 @@
 Call layout
 ===========
 
-You can switch between grid view and speaker view using the toggle icon in the three-dot menu or the bottom bar.
+You can switch between ``Grid view``, ``Speaker view`` and ``Multi-speaker view`` using the layout menu in the
+bottom bar. Talk remembers your choice for each conversation.
 
+.. TODO: update screenshot to show the layout menu with grid, speaker and multi-speaker view
 .. image:: images/call-view-toggle-button.png
-    :alt: Talk call view toggle button to switch between grid and speaker view
+    :alt: Talk call layout menu to switch between grid, speaker and multi-speaker view
     :width: 300px
 
 Grid view
@@ -26,3 +28,17 @@ Use the navigation buttons on the left and right to scroll through participants
 .. image:: images/talk-promoted-view.png
     :alt: Talk call in promoted (speaker) view with the active speaker highlighted
     :width: 700px
+
+Multi-speaker view
+-------------------
+
+Multi-speaker view works like speaker view, but shows up to three active speakers in large tiles instead of just
+one, so you can follow a discussion between several people at once. A participant moves to a large tile after
+speaking for a few seconds, and goes back to the row after about 30 seconds of silence.
+
+Multi-speaker view is not available when the call is shown in the sidebar.
+
+.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture
+.. image:: images/talk-promoted-view.png
+    :alt: Talk call in multi-speaker view with several active speakers highlighted
+    :width: 700px

user_manual/talk/conversation_organization.rst

@@ -13,6 +13,7 @@ Tags
 Create custom tags to categorize your conversations and keep them organized.
 Tags help you group conversations by project, team, topic, or any other criteria that makes sense for your workflow.
 
+.. TODO: update screenshot to show the last message time next to each conversation
 .. image:: images/conversations-tag-overview.png
     :alt: Talk conversations tag appearance
     :width: 400px
@@ -23,6 +24,13 @@ Tags help you group conversations by project, team, topic, or any other criteria
 
 You can later manage existing tags by renaming, reordering or deleting them.
 
+When you collapse a tag, Talk can still show its unread conversations. In the Talk settings, choose an option for
+``Show unread conversations under collapsed tags``:
+
+- **Off**: Hide all conversations of a collapsed tag
+- **@-mentions only**: Show conversations with unread mentions
+- **All messages**: Show conversations with any unread message (default)
+
 .. image:: images/conversations-tag-actions.png
     :alt: Talk conversations tag actions
     :width: 400px
@@ -42,6 +50,10 @@ Similar types can also be grouped together:
 - **Show private ones first**: Show private conversations before groups/public
 - **Show group ones first**: Show groups/public conversations before private
 
+Each conversation in the list shows the time of its last message: the time for today, the weekday for the last
+seven days, and the date for older messages. The time is hidden in the compact view of the conversation list.
+
+.. TODO: update screenshot to show the last message time next to each conversation
 .. image:: images/conversations-sorting.png
     :alt: Talk conversations sorting and grouping options
     :width: 400px

user_manual/talk/conversation_presets.rst

@@ -13,6 +13,7 @@ Available presets
 Depending on your instance configuration, you may see presets when creating a new conversation.
 Each preset applies a specific set of defaults suited to a particular use case.
 
+.. TODO: update screenshot to show the Conversation type field with the classified, channel and announcement presets
 .. image:: images/new-conversation-presets.png
     :alt: Talk new conversation dialog with presets selection
     :width: 400px
@@ -40,6 +41,54 @@ Presentation
 Presentation preset is useful for internal meetings, where it is expected to have more listeners than speakers.
 Participant permissions are optimized to ensure the best performance and moderation experience, allowing presenters to speak uninterrupted.
 
+Classified conversation
+------------------------
+
+A locked-down conversation preset for confidential topics. A classified conversation cannot be made public or open
+to other users on the server, so there is no public link and no guest access. Federation, SIP dial-in and dial-out,
+invitations by email or phone, call recording, live transcription, bots, bridges, breakout rooms and AI summaries
+are disabled. Messages expire after one hour by default.
+
+The conversation is always marked as sensitive: notifications and activities show ``Private conversation`` instead
+of its name and do not reveal message content. Message translation and private replies from other conversations are
+not available.
+
+After a call ends, the whole conversation is deleted for everyone after a period of inactivity (one hour by default).
+A notice in the chat shows when the deletion happens. Moderators can click ``Delete now`` to delete it immediately,
+or ``Keep`` to keep the conversation.
+
+.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture
+.. image:: images/new-conversation-presets.png
+    :alt: Talk new conversation dialog with the classified conversation preset selected
+    :width: 400px
+
+Channel
+-------
+
+A broadcast conversation preset for a large audience. Only moderators can post messages; everyone else can only
+react, unless a moderator grants individual participants more permissions. Calls are disabled for everyone, including
+moderators. The conversation is visible to and can be joined by other users on the server. Only moderators can see
+the participant list and system messages.
+
+.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture
+.. image:: images/new-conversation-presets.png
+    :alt: Talk new conversation dialog with the channel preset selected
+    :width: 400px
+
+Announcement
+------------
+
+An announcement preset works like a channel, with the same posting and call restrictions, but the conversation is
+not open for other users to join, and participants who are added to it cannot leave. Participants get a notification
+for every message by default, and they can change this in the notification settings.
+
+.. note:: Only administrators can create announcements.
+
+.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture
+.. image:: images/new-conversation-presets.png
+    :alt: Talk new conversation dialog with the announcement preset selected
+    :width: 400px
+
 See also:
 
 - :doc:`conversations`

user_manual/talk/conversations.rst

@@ -72,9 +72,11 @@ The Talk Dashboard is your central hub for managing and accessing your conversat
 
 - Unread mentions and messages in private chats;
 - Message reminders, scheduled to be tackled on later;
-- Scheduled meetings, with event details and shortcut buttons to join them;
-- Shortcut actions to create new conversations, join open ones, or quickly check your media devices.
+- Upcoming meetings, with event details and shortcut buttons to join them;
+- Shortcut actions to start a meeting now, create new conversations, join open ones, call a phone number,
+  or check your media devices.
 
+.. TODO: update screenshot to reflect the redesigned Talk dashboard panel
 .. image:: images/talk-dashboard.png
     :alt: Talk dashboard showing recent conversations and shortcut actions
     :width: 600px
@@ -96,6 +98,7 @@ If you want to create a custom group conversation, click the button next to the
 
 You can then pick a name for the conversation, put a description, and set up an avatar for it (with uploaded photo or emoji), and select if the conversation should be open to external users and if other users on the server can see and join the conversation.
 
+.. TODO: update screenshot to show the Conversation type field in the new conversation dialog
 .. image:: images/creating-open-conversation.png
     :alt: Talk new conversation setup dialog for name, description, and access type
     :width: 500px
@@ -120,12 +123,14 @@ You can filter your conversations using the filter button next to the search fie
 2. **Unread messages**: view unread messages in all conversations you are a part of.
 3. **Meeting conversations**: view all conversations, created for upcoming or past events.
 
+.. TODO: update screenshot to show the last message time next to each conversation
 .. image:: images/filters-menu.png
     :alt: Talk conversation list filter menu
     :width: 400px
 
 You can then clear the filter from the filters menu.
 
+.. TODO: update screenshot to show the last message time next to each conversation
 .. image:: images/clear-filter.png
     :alt: Talk conversation list with active filter and clear filter option
     :width: 400px
@@ -135,6 +140,7 @@ Archive conversations
 You can archive conversations that you no longer need to see in your main conversation list. When a conversation is archived, it will be moved to the ``Archived conversations`` section.
 An archived conversation will not appear in your main conversation list, but it will still align with notification level set in its settings.
 
+.. TODO: update screenshot to show the last message time next to each conversation
 .. image:: images/archived-conversations-list.png
     :alt: Talk list of archived conversations
     :width: 400px
@@ -145,13 +151,23 @@ The list is accessible from the button at the bottom of the navigation bar.
     :alt: Talk navigation bar showing the archived conversations button
     :width: 400px
 
+To unarchive conversations automatically when new messages arrive, open the Talk settings and choose an option
+for ``Unarchive conversation when new messages are received``:
+
+- **Off**: Keep conversations archived (default)
+- **@-mentions only**: Unarchive on a mention or a reply to your message, and on any message in private chats
+- **All messages**: Unarchive on any new message
+
+Your own messages never unarchive a conversation.
+
 Managing a conversation
 -----------------------
 
 You are always moderator in your new conversation. In the participant list you can promote other participants to moderators using the ``...`` menu to the right of their user name, assign them custom permissions or remove them from the conversation.
 
 Changing permissions of a user that joined a public conversation will also permanently add them to the conversation.
 
+.. TODO: update screenshot to show the owner badge and owner actions in the participant menu
 .. image:: images/participant-menu.png
     :alt: Talk participant menu showing permission and moderation options
     :width: 400px
@@ -164,10 +180,47 @@ Moderators can configure the conversation. Select ``Conversation settings`` from
 
 Here you can configure the description, guest access, if the conversation is visible to others on the server and more.
 
+.. TODO: update screenshot to show the Danger zone section with the Preserve conversation setting
 .. image:: images/conversation-settings-dialog.png
    :alt: Talk conversation settings dialog showing description and access configuration
    :width: 600px
 
+Owner role
+----------
+
+The person who created a group conversation is its owner. Owners are marked with the ``Owner`` badge in the
+participant list. An owner can promote other users to owners with ``Promote to owner`` in the participant list
+``...`` menu. To demote an owner, choose ``Demote from owner to moderator`` or ``Demote from owner to participant``.
+Guests, federated users and phone participants cannot become owners.
+
+.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture
+.. image:: images/participant-menu.png
+    :alt: Talk participant menu with promote/demote owner options
+    :width: 400px
+
+Only owners can promote or demote owners. An owner cannot be removed from the conversation, so demote them first.
+You can step down from the owner role yourself, but only to moderator. The last owner or moderator of a conversation
+cannot be demoted to participant.
+
+Preserved conversations
+------------------------
+
+An owner can mark a conversation as preserved, for conversations that must be kept for record-keeping or compliance
+reasons. While a conversation is preserved, nobody can delete it, clear its chat history, or change its guest access
+and whether other users on the server can see and join it.
+
+To preserve a conversation, open ``Conversation settings`` and turn on ``Preserve conversation`` in the
+``Danger zone`` section. Moderators can see this setting, but only owners can change it. To stop preserving the
+conversation, turn the setting off and confirm by typing the conversation token.
+
+.. note:: Preserving does not stop the automatic deletion of a classified conversation after a call.
+   See :doc:`conversation_presets`.
+
+.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture
+.. image:: images/conversation-settings-dialog.png
+    :alt: Talk conversation settings showing the preserve conversation option
+    :width: 600px
+
 Ban participants
 ----------------
 

user_manual/talk/federation_index.rst

@@ -33,6 +33,7 @@ Upon clicking it, more information will be provided about the inviting party, an
 
 By accepting the invite, the conversation will appear in the list as any other one.
 
+.. TODO: update screenshot to show the last message time next to each conversation
 .. image:: images/federation-conversations-list.png
    :alt: Talk conversation list showing a federated conversation from another server
    :width: 400px