fix(user): Tidy text and headers across Talk user documentation

- Fix grammar, articles, sentence case headings, stale intro text,
duplicate content, and minor phrasing issues throughout Talk pages.
- AI-assisted changes

Signed-off-by: Maksim Sukharev <antreesy.web@gmail.com>

Author: Antreesy

user_manual/talk/appearance.rst

@@ -5,7 +5,7 @@ Appearance
 Compact view of conversations list
 ----------------------------------
 
-Compact view allows to hide last message preview in the conversation list, providing a more focused interface.
+Compact view hides last message preview in the conversation list, providing a more focused interface.
 
 .. image:: images/talk-compact-view.png
    :width: 200px
@@ -16,7 +16,7 @@ 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.
+You can change both settings from the ``Talk settings`` dialog in the ``Appearance`` section.
 
 .. image:: images/talk-appearance-settings.png
    :width: 600px

user_manual/talk/attachments.rst

@@ -5,7 +5,7 @@ Attachments
 Sharing files in a chat
 -----------------------
 
-You can share files in a chat in 3 ways.
+You can share files in a chat in three ways.
 
 First, you can simply drag'n'drop them on the chat.
 
@@ -43,17 +43,17 @@ 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.
+You can also import polls for auto-fill and export polls as JSON files to save them locally.
 
 .. image:: images/import-poll.png
    :width: 400px
 
-Closing poll is possible from the poll dialog.
+You can close a poll 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. 
+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

user_manual/talk/breakout_rooms.rst

@@ -1,22 +1,20 @@
 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.
+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".
+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:
+You have three 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.
@@ -33,7 +31,7 @@ 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
+From the sidebar header, you can:
 
 - **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.

user_manual/talk/calendar_integration.rst

@@ -4,7 +4,7 @@ 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.
+If calendar events have a Talk conversation set as event location, you will see 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.
 
@@ -25,7 +25,7 @@ When creating a new event in Calendar, you can set a Talk conversation as event
 .. 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).
+When the event is created, you will see a link to the conversation in the event details. The conversation will also appear in the list of conversations (discoverable by ``Events`` filter).
 
 .. image:: images/event-conversation-list.png
    :width: 300px

user_manual/talk/call.rst

@@ -86,7 +86,7 @@ The table in the CSV file contains the following columns:
 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).
+Call live transcription transcribes 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.
 

user_manual/talk/call_recording.rst

@@ -1,7 +1,7 @@
 Call recording
 ==============
 
-The recording feature provides users with an opportunity to:
+The recording feature lets you:
 
 - Start and stop recordings during a call.
 - Record the video and audio stream of the speaker, as well as screen share.
@@ -43,7 +43,7 @@ After stopping a recording, the server will take some time to prepare and save t
 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:
+For compliance with privacy regulations, it is possible to ask participants for consent to be recorded before joining the call. Administrators can configure this feature in several ways:
 
 - Disable consent completely.
 - Enable mandatory consent system-wide, requiring consent for all conversations.

user_manual/talk/chat.rst

@@ -5,7 +5,7 @@ Sending messages
 Using Markdown
 ---------------
 
-You can enhance your messages with a markdown syntax support. See list for usage:
+You can enhance your messages using Markdown syntax. Supported elements:
 
 **Headings and dividers**
 
@@ -81,8 +81,8 @@ You can add emoji using the picker on the left of the text input field.
 Smart Picker
 ------------
 
-Smart picker shortcut makes it easier to insert links, files, or other content into your conversations.
-Just choose the type of content you want to insert (files, Talk conversations, Deck cards, GIFs, etc.)
+The smart picker makes it easier to insert links, files, or other content into your conversations.
+Just choose the type of content you want to insert (files, Talk conversations, Deck cards, GIFs, etc.).
 You can also type `/` in the chat input to open the selector.
 
 .. image:: images/smart-picker.png
@@ -130,7 +130,7 @@ You can find all your scheduled messages by clicking on the clock icon next to t
 Chat summary
 ------------
 
-When AI assistant is enabled, a summary can be generated if there are more than 100 unread messages.
+When AI assistant is enabled, a summary can be generated for a conversation if there are more than 100 unread messages.
 You can generate it by pressing the button that is visible in chat above the first unread messages.
 
 .. image:: images/chat-summary-button.png

user_manual/talk/conversations.rst

@@ -2,15 +2,13 @@
 Conversations
 =============
 
-Nextcloud Talk lets you chat and have video calls on your own server.
-
 Chats and calls take place in conversations. You can create any number of conversations. There are different types of conversations:
 
 1. Private (one-to-one) conversations
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 This is where you have a private chat or call with another Talk user.
 
-In content sidebar, you can find additional information about the person you are chatting with, such as their email address, phone number, or other details they have shared in their profile.
+In the content sidebar, you can find additional information about the person you are chatting with, such as their email address, phone number, or other details they have shared in their profile.
 
 .. image:: images/one-to-one-right-sidebar.png
     :width: 300px
@@ -21,7 +19,7 @@ You can extend an ongoing call to a new group conversation by adding more people
 .. image:: images/one-to-one-extend.png
     :width: 300px
 
-If a user becomes unavailable and set an **out-of-office** status in ``Personal settings > Availability``, you will find additional information in this conversation, such as provided description, absence date, or their replacement person.
+If a user becomes unavailable and has set an **out-of-office** status in ``Personal settings > Availability``, you will find additional information in this conversation, such as provided description, absence date, or their replacement person.
 
 .. image:: images/one-to-one-out-of-office.png
     :width: 500px
@@ -108,7 +106,7 @@ Filter your conversations
 You can filter your conversations using the filter button next to the search field. There are several options for filtering:
 1. **Unread mentions**: view unread private conversations, or group conversations, where you have been mentioned.
 2. **Unread messages**: view unread messages in all conversations you are a part of.
-2. **Event conversations**: view all conversations, created for upcoming or past events.
+3. **Event conversations**: view all conversations, created for upcoming or past events.
 
 .. image:: images/filters-menu.png
     :width: 400px
@@ -155,9 +153,9 @@ Ban participants
 ----------------
 
 To help keep discussions safe and under control, moderators can ban participants from conversations.
-It could be internal users or guests (in this case their IP-addresse will additionally be banned).
+This applies to internal users and guests alike; for guests, their IP address will also be banned.
 
-In the participants list, select the user or guest you, and click ``Remove participant``.
+In the participants list, select the user or guest, and click ``Remove participant``.
 
 .. image:: images/ban-participant.png
     :width: 300px

user_manual/talk/federation.rst

@@ -1,35 +1,36 @@
 Federation
 ==========
-With Federation feature, users can create conversations across different federated Talk instances and use Talk features as if they were on a same server.
 
-Feature is required to be set up by the system administration.
+With the Federation feature, users can create conversations across different federated Talk instances and use Talk features as if they were on the same server.
+
+This feature must be enabled by a system administrator.
 
 Sending an invitation
 ---------------------
 
 .. FIXME document where a user can find their CloudID to get invited
 
-The moderator of the conversation can send an invite to participant on a different server:
+The moderator of the conversation can send an invite to a participant on a different server:
 
 .. image:: images/federation-invite-send.png
    :width: 400px
 
 Accepting an invitation
 -----------------------
 
-When receiving a notification, user will see a counter of pending invites above the conversations list.
+When receiving a notification, the user will see a counter of pending invites above the conversations list.
 
 .. image:: images/federation-invite-pending.png
    :width: 400px
 
-Upon clicking it, more information will be provided about inviting party, and user can either accept or decline the invitation.
+Upon clicking it, more information will be provided about the inviting party, and the user can either accept or decline the invitation.
 
 .. image:: images/federation-invite-dialog.png
    :width: 500px
 
-By accepting the invite, conversation will appear in the list as any other one.
+By accepting the invite, the conversation will appear in the list as any other one.
 
 .. image:: images/federation-conversations-list.png
    :width: 400px
 
-You can use it further to chat with participants from other federated servers, join calls and use other available Talk features.
+You can use it to chat with participants from other federated servers, join calls, and use other available Talk features.

user_manual/talk/files_integration.rst

@@ -4,7 +4,7 @@ Files integration
 Talk from Files
 ---------------
 
-In the Files app, you can chat about files in the sidebar, and even have a call while editing it. You first have to join the chat.
+In the Files app, you can chat about files in the sidebar, and even have a call while editing the file. You first have to join the chat.
 
 .. image:: images/join-chat.png
     :width: 500px