From 2c1efc836361ec33e3be0fabb219a276d536b92f Mon Sep 17 00:00:00 2001 From: Maksim Sukharev Date: Fri, 4 Sep 2026 17:37:19 +0200 Subject: [PATCH] [wip] feat(talk): add user documentation for 35 features [skip ci] Assisted-by: ClaudeCode:claude-sonnet-5 Signed-off-by: Maksim Sukharev --- user_manual/talk/attachments.rst | 17 ++++++++-- user_manual/talk/call.rst | 12 +++++++ user_manual/talk/call_views.rst | 11 ++++++ .../talk/conversation_organization.rst | 1 + user_manual/talk/conversation_presets.rst | 34 +++++++++++++++++++ user_manual/talk/conversations.rst | 24 +++++++++++++ user_manual/talk/messages.rst | 14 +++++++- 7 files changed, 109 insertions(+), 4 deletions(-) diff --git a/user_manual/talk/attachments.rst b/user_manual/talk/attachments.rst index 3d7680eb7c7..3d74b49b39e 100644 --- a/user_manual/talk/attachments.rst +++ b/user_manual/talk/attachments.rst @@ -23,13 +23,24 @@ 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: update screenshot to show multiple files combined into one message .. 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 compresses them to save bandwidth and storage; switch +to ``Original image quality`` if you need to share the full-quality file. Depending on your instance, you can also +choose ``View-only for others`` (the default) or ``Editable by others`` for the shared files. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. 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 diff --git a/user_manual/talk/call.rst b/user_manual/talk/call.rst index 79326d464c2..cc8e4734319 100644 --- a/user_manual/talk/call.rst +++ b/user_manual/talk/call.rst @@ -81,6 +81,18 @@ 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 `. +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 +only, 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, you can still join one already in progress, but you will not see the +``Start call`` button. 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 ^^^^^^^^^^^^^^ diff --git a/user_manual/talk/call_views.rst b/user_manual/talk/call_views.rst index 4e2d04a824f..0d5c3ddc6d4 100644 --- a/user_manual/talk/call_views.rst +++ b/user_manual/talk/call_views.rst @@ -26,3 +26,14 @@ 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 promotes two or three active speakers into large tiles instead of +just one, so you can follow a discussion between several people at once. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. image:: images/talk-promoted-view.png + :alt: Talk call in multi-speaker view with several active speakers highlighted + :width: 700px diff --git a/user_manual/talk/conversation_organization.rst b/user_manual/talk/conversation_organization.rst index 16b5c9aa21c..4c82d6a33fc 100644 --- a/user_manual/talk/conversation_organization.rst +++ b/user_manual/talk/conversation_organization.rst @@ -42,6 +42,7 @@ 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 +.. 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 diff --git a/user_manual/talk/conversation_presets.rst b/user_manual/talk/conversation_presets.rst index f4a6f1c6ec7..d79ca225c57 100644 --- a/user_manual/talk/conversation_presets.rst +++ b/user_manual/talk/conversation_presets.rst @@ -40,6 +40,40 @@ 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. It cannot be made public, so there is no public link and +no guest access, and SIP dial-in/out and call recording are disabled. Messages expire after one hour by default. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. 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, and the conversation +is searchable and joinable by registered users. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. 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 openly joinable and participants who are added to it cannot leave. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. image:: images/new-conversation-presets.png + :alt: Talk new conversation dialog with the announcement preset selected + :width: 400px + See also: - :doc:`conversations` diff --git a/user_manual/talk/conversations.rst b/user_manual/talk/conversations.rst index 9c666f7e75b..17c7780c934 100644 --- a/user_manual/talk/conversations.rst +++ b/user_manual/talk/conversations.rst @@ -168,6 +168,30 @@ Here you can configure the description, guest access, if the conversation is vis :alt: Talk conversation settings dialog showing description and access configuration :width: 600px +Owner role +---------- + +The person who created a conversation is its owner. An owner can promote other moderators to owners, and demote +co-owners back to moderator, from the participant list ``...`` menu. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. image:: images/participant-menu.png + :alt: Talk participant menu with promote/demote owner options + :width: 400px + +Unlike moderators, an owner cannot be removed or demoted by another moderator, only by another owner. + +Preserved conversations +------------------------ + +An owner can mark a conversation as preserved, to protect it from accidental deletion, purging or from having its +visibility changed. This is useful for conversations that must be kept for record-keeping or compliance reasons. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. image:: images/conversation-settings-dialog.png + :alt: Talk conversation settings showing the preserve conversation option + :width: 600px + Ban participants ---------------- diff --git a/user_manual/talk/messages.rst b/user_manual/talk/messages.rst index 6dd1fd79ead..efe01a59415 100644 --- a/user_manual/talk/messages.rst +++ b/user_manual/talk/messages.rst @@ -43,10 +43,22 @@ In the submenu, you can select an appropriate time to receive a notification lat You can also forward a message to another conversation using the ``...`` menu, or send it to your **Note to self** conversation for personal reference. +Global message search +---------------------- + +You can search for messages across all your conversations at once from the conversation list search field, without +opening each conversation individually. Results show a preview of the matching message and its conversation, so you +can jump straight to it. + +.. TODO: mock screenshot below, replace with a real capture once the feature ships +.. image:: images/chat-search-messages.png + :alt: Talk global search results showing matching messages across conversations + :width: 500px + Messages search in a conversation --------------------------------- -In addition to global unified search, you can search for messages within a specific conversation. In the content sidebar of a conversation, click the search icon to open the search tab. +In addition to the global message search, you can search for messages within a specific conversation. In the content sidebar of a conversation, click the search icon to open the search tab. .. image:: images/chat-search-messages.png :alt: Talk in-conversation message search field