fix(a11y): add missing alt text to Talk and KDE sync images

user_manual/groupware/sync_kde.rst

@@ -11,50 +11,64 @@ In KOrganizer:
 1. Open KOrganizer and in the calendar list (bottom left) right-click and choose ``Add Calendar``:
 
 .. image:: ../images/KOrganizer_add_calendar.png
+   :alt: KOrganizer calendar list context menu with Add option
 
 2. In the resulting list of resources, pick ``DAV groupware resource``:
 
 .. image:: ../images/korganizer_resource_choice.png
+   :alt: KOrganizer resource type list with DAV groupware resource selected
 
 In Kalendar:
 
 1. Open Kalendar and in the menu bar open the setting and then choose ``Calendar Sources`` -> ``Add Calendar``:
 
 .. image:: ../images/Kalendar_add_calendar.png
+   :alt: Kalendar settings menu showing Add Calendar option
 
 2. In the resulting list of resources, pick ``DAV groupware resource``:
 
 .. image:: ../images/kalendar_resource_choice.png
+   :alt: Kalendar resource selection dialog with DAV groupware resource option
 
 In KOrganizer and Kalendar:
 
 3. Enter your username. As password, you need to generate an app-password/token (:ref:`Learn more <managing_devices>`):
 
 .. image:: ../images/korganizer_credentials.png
+   :alt: KOrganizer credentials dialog for entering username and app password
 
 4. Choose ``Nextcloud`` as Groupware server option:
 
 .. image:: ../images/KOrganizer_groupware_server.png
+   :alt: KOrganizer groupware server selection showing Nextcloud option
 
 5. Enter your Nextcloud server URL and, if needed, installation path (anything that comes after the first /, for example ``mynextcloud`` in ``https://example.com/mynextcloud``). Then click next:
 
 .. image:: ../images/KOrganizer_server_address.png
+   :alt: KOrganizer server URL configuration dialog
 
 6. You can now test the connection, which can take some time for the initial connection. If it does not work, you can go back and try to fix it with other settings:
 
 .. image:: ../images/KOrganizer_test1.png
+   :alt: KOrganizer connection test in progress
 
 .. image:: ../images/KOrganizer_test2.png
+   :alt: KOrganizer successful connection test result
 
 7. Pick a name for this resource, for example ``Work`` or ``Home``. By default, both CalDAV (Calendar) and CardDAV (Contacts) are synced:
 
 .. image:: ../images/KOrganizer_pick_resources.png
+   :alt: KOrganizer resource naming and calendar selection dialog
 
 .. note:: You can set a manual refresh rate for your calendar and contacts resources. By default this setting is set to 5 minutes and should be fine for the most use cases. When you create a new appointment it is synced to Nextcloud right away. You may want to change this for saving your power or cellular data plan, so that you can update with a right-click on the item in the calendar list.
 
 8. After a few seconds to minutes depending on your internet connection, you will find your calendars and contacts inside the KDE Kontact applications KOrganizer, Kalendar and KAddressBook as well as Plasma calendar applet:
 
 .. image:: ../images/KOrganizer.png
+   :alt: KOrganizer calendar application showing synchronized Nextcloud events
 .. image:: ../images/KDEPlasma.png
+   :alt: KDE Plasma desktop with Nextcloud calendar events in the system calendar widget
 .. image:: ../images/kalendar_month_view.png
+   :alt: Kalendar month view showing synchronized Nextcloud calendar events
 .. image:: ../images/KAddressBook.png
+   :alt: KAddressBook contacts application showing synchronized Nextcloud contacts

user_manual/talk/appearance.rst

@@ -8,6 +8,7 @@ Compact view of conversations list
 Compact view hides last message preview in the conversation list, providing a more focused interface.
 
 .. image:: images/talk-compact-view.png
+   :alt: Talk conversation list in compact view without message previews
    :width: 200px
 
 Chat messages
@@ -19,4 +20,5 @@ You can choose between classic list or message bubbles, with your own messages o
 You can change both settings from the ``Talk settings`` dialog in the ``Appearance`` section.
 
 .. image:: images/talk-appearance-settings.png
+   :alt: Talk settings dialog showing compact view and other appearance options
    :width: 600px

user_manual/talk/attachments.rst

@@ -10,24 +10,29 @@ You can share files in a chat in three ways.
 First, you can simply drag'n'drop them on the chat.
 
 .. image:: images/drag-and-drop.png
+   :alt: Talk chat with a file being dragged and dropped to share
    :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
+   :alt: Talk file selection dialog for sharing from Nextcloud Files
    :width: 500px
 
 .. image:: images/share-files-in-chat-selection.png
+    :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.
 
 .. image:: images/talk-upload-files.png
+   :alt: Talk file upload queue before sending files in chat
    :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.
 
 .. image:: images/editing-document-in-chat-room.png
+   :alt: Talk chat with a shared document that participants can open and edit
    :width: 600px
 
 Polls in chat
@@ -36,6 +41,7 @@ Polls in chat
 You can create a poll in groups chats from the new message additional actions.
 
 .. image:: images/create-new-poll.png
+   :alt: Talk poll creation form in a group chat
    :width: 400px
 
 A poll has two settings:
@@ -46,21 +52,25 @@ A poll has two settings:
 You can also import polls for auto-fill and export polls as JSON files to save them locally.
 
 .. image:: images/import-poll.png
+   :alt: Talk poll import option for loading poll questions from a file
    :width: 400px
 
 You can close a poll from the poll dialog.
 
 .. image:: images/close-poll.png
+   :alt: Talk poll dialog with option to close voting
    :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
+   :alt: Talk poll creation form with save as draft option
    :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
+   :alt: Talk shared items tab showing saved poll drafts
    :width: 400px
 
 

user_manual/talk/bots.rst

@@ -29,4 +29,5 @@ Administrators can configure, enable and disable commands. Users can use the ``h
     ``/help``
 
 .. image:: images/command-help.png
+    :alt: Talk chat showing the /help command output listing available bot commands
     :width: 600px

user_manual/talk/breakout_rooms.rst

@@ -13,6 +13,7 @@ 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
+    :alt: Talk Breakout rooms setup button in conversation controls
     :width: 400px
 
 A dialog will open where you can specify the number of rooms you want to create and the participants assignment method.
@@ -23,6 +24,7 @@ You have three options:
 - **Allow participants to choose**: Participants will be able to join breakout rooms themselves.
 
 .. image:: images/talk-breakout-rooms-setup-dialog.png
+    :alt: Talk breakout rooms configuration dialog showing participant assignment options
     :width: 500px
 
 Manage breakout rooms
@@ -31,6 +33,7 @@ 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
+    :alt: Talk sidebar showing created breakout rooms
     :width: 500px
 
 From the sidebar header, you can:
@@ -40,12 +43,14 @@ From the sidebar header, you can:
 - **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
+    :alt: Talk breakout rooms sidebar header with start and manage options
     :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
+    :alt: Talk individual breakout room entry in the sidebar with join option
     :width: 400px
 
 .. FIXME Ask for assistance, demo "free selection for a user"

user_manual/talk/calendar_integration.rst

@@ -9,12 +9,14 @@ That way you can stay informed about scheduled meetings or activities directly w
 If Calendar app is enabled, you can click on an event to view details.
 
 .. image:: images/events-upcoming.png
+    :alt: Talk conversation showing upcoming calendar events
     :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
+   :alt: Talk conversation with schedule meeting option to invite participants
    :width: 500px
 
 Schedule from Calendar
@@ -23,11 +25,13 @@ 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
+   :alt: Nextcloud Calendar new event dialog with Talk conversation link option
    :width: 600px
 
 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
+   :alt: Nextcloud Calendar event view showing a linked Talk conversation
    :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

@@ -12,6 +12,7 @@ When you are part of a conversation and have permission to do so, you can start
 When a call is already in progress, join it by clicking the green ``Join call`` button in the chat area or the top bar.
 
 .. image:: images/join-call.png
+    :alt: Talk conversation with a green Join call button
     :width: 600px
 
 .. note:: If you have not yet given permission to the browser or the Talk Desktop client to use your microphone and camera,
@@ -21,6 +22,7 @@ When a call is already in progress, join it by clicking the green ``Join call``
 You will see ``Media settings``, where you can customise your call experience:
 
 .. image:: images/calls/media-settings-initial.png
+    :alt: Talk media settings dialog before joining a call
     :width: 600px
 
 Controlling audio and video
@@ -35,6 +37,7 @@ Use the microphone and camera icons at the bottom of the video preview to mute o
 Device settings allow you to choose which microphone and camera you want to use. This is useful if you have more than one microphone or camera available:
 
 .. image:: images/calls/media-settings-devices.png
+    :alt: Talk media settings showing microphone and camera device selection
     :width: 400px
 
 Backgrounds
@@ -45,6 +48,7 @@ You can also upload your own image or choose one already in Nextcloud Files.
 Alternatively, choose the ``blur`` option to blur your live video background.
 
 .. image:: images/calls/media-settings-backgrounds.png
+    :alt: Talk media settings showing virtual background and blur options for video
     :width: 400px
 
 Immediately join a call
@@ -70,9 +74,11 @@ If you do not want to notify the other participants, start a silent call by open
 and choosing ``Call without notification``.
 
 .. image:: images/calls/media-settings-silent-call.png
+    :alt: Talk Call without notification option in media settings
     :width: 400px
 
 .. image:: images/calls/media-settings-silent-call-2.png
+    :alt: Talk confirmation step for calling without sending a notification
     :width: 400px
 
 .. note:: Other participants can modify notifications on a per-conversation level, including whether they want to receive call notifications.
@@ -103,6 +109,7 @@ During a call
 After you join a call, you will see the call view. It shows the video feeds of all participants currently in the call, with additional information and controls.
 
 .. image:: images/calls/during-a-call-details.png
+    :alt: Talk active call view showing participant video feeds
     :width: 400px
 
 The leftmost element shows the elapsed call time.
@@ -114,11 +121,13 @@ Participants that have joined the call will be listed first.
 You will also see each participant's talking time if they have spoken during the call:
 
 .. image:: images/calls/participant-talk-time.png
+    :alt: Talk active call showing talking time indicator for each participant
     :width: 400px
 
 You can access additional call options and settings from the three-dot menu in the top bar.
 
 .. image:: images/media-settings.png
+    :alt: Talk in-call three-dot menu for additional settings and options
     :width: 300px
 
 Set up breakout rooms
@@ -134,6 +143,7 @@ Download call participants list
 You can download the list of participants in a call from the three-dot menu in the top bar. This downloads a CSV file with the names and email addresses of all participants.
 
 .. image:: images/download-participants-list.png
+   :alt: Talk in-call menu showing download participants list option
    :width: 400px
 
 The CSV file contains the following columns:
@@ -149,6 +159,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.
 
 .. image:: images/calls/during-a-call-controls.png
+    :alt: Talk active call bottom bar showing media controls and layout settings
     :width: 400px
 
 Use the microphone and camera icons to mute/unmute your microphone and enable/disable your camera.
@@ -161,6 +172,7 @@ Reactions
 The reactions button lets you send an emoji reaction to all participants in the call.
 
 .. image:: images/calls/call-reactions.png
+    :alt: Talk active call reactions panel with emoji options
     :width: 400px
 
 Every participant will see the emoji rising from the bottom of their call screen. The emoji disappears after two seconds.

user_manual/talk/call_recording.rst

@@ -20,26 +20,31 @@ The moderator of the conversation can start a recording together with a call sta
 - **During the call**: click on the top-bar menu, then click "Start recording".
 
 .. image:: images/start-recording-before-call.png
+    :alt: Talk media settings showing start recording option before joining a call
     :width: 400px
 
 |
 
 .. image:: images/start-recording-in-call.png
+    :alt: Talk in-call top bar menu showing Start recording option
     :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
+    :alt: Talk active call with red recording indicator and stop recording option
     :width: 500px
 
 After stopping a recording, the server will take a few seconds 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
+    :alt: Talk notification that a call recording is ready to share
     :width: 300px
 
 |
 
 .. image:: images/shared-recordings.png
+    :alt: Talk chat showing a shared call recording file
     :width: 400px
 
 Recording consent
@@ -52,6 +57,7 @@ For compliance with privacy regulations, it is possible to ask participants for
 - 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
+    :alt: Talk admin settings for enabling recording consent requirement
     :width: 500px
 
 .. FIXME make screenshots below from user perspective not moderator
@@ -60,6 +66,7 @@ If recording consent is enabled, every participant, including moderators, will s
 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
+    :alt: Talk recording consent dialog with checkbox to accept recording
     :width: 500px
 
 After a call ends, the recording is processed and saved to the chat as a shared file. Participants can play it back directly from the chat or download it from the conversation's shared items.

user_manual/talk/call_screenshare.rst

@@ -12,6 +12,7 @@ Depending on your browser or the Talk Desktop client, you will get the option to
 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
+    :alt: Talk call with both screen share and camera video visible
     :width: 700px
 
 To stop sharing your screen, click the ``Share screen`` button again and choose ``Stop screensharing``.

user_manual/talk/call_transcription.rst

@@ -10,6 +10,7 @@ Moderators need to set the transcription language in the conversation settings.
 When enabled, the transcription appears at the bottom of the screen and is updated in real-time.
 
 .. image:: images/call-transcription.png
+   :alt: Talk call with live transcription text displayed at the bottom of the screen
    :width: 500px
 
 Live translation
@@ -18,4 +19,5 @@ Live translation
 With the `live_transcription` provider app enabled, you can also use live translation. Instead of receiving the transcription in the original language, it will be translated to the language of your choice.
 
 .. image:: images/call-translation-actions.png
+   :alt: Talk call transcription toolbar with translation and other actions
    :width: 400px

user_manual/talk/call_views.rst

@@ -5,6 +5,7 @@ Call layout
 You can switch between grid view and speaker view using the toggle icon in the three-dot menu or the bottom bar.
 
 .. image:: images/call-view-toggle-button.png
+    :alt: Talk call view toggle button to switch between grid and speaker view
     :width: 300px
 
 Grid view
@@ -13,6 +14,7 @@ Grid view
 Grid view shows all participants as tiles. Use the navigation buttons on the left and right to scroll through participants when they do not all fit on the screen.
 
 .. image:: images/talk-grid-view.png
+    :alt: Talk call in grid view showing multiple participants
     :width: 700px
 
 Speaker view
@@ -22,4 +24,5 @@ Speaker view (also called promoted view) centres the active speaker in a large t
 Use the navigation buttons on the left and right to scroll through participants when the row overflows.
 
 .. image:: images/talk-promoted-view.png
+    :alt: Talk call in promoted (speaker) view with the active speaker highlighted
     :width: 700px