feat(talk): add user documentation for 35 features

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

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 <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
 ^^^^^^^^^^^^^^
 

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

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

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`

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
 ----------------
 

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