Merge pull request #12159 from nextcloud/feat/noid/talk-screenshots-30

user_manual/talk/advanced_features.rst

@@ -11,6 +11,7 @@ Matterbridge integration in Nextcloud Talk makes it possible to create 'bridges'
 A moderator can add a Matterbridge connection in the chat conversation settings.
 
 .. image:: images/matterbridge-settings.png
+    :width: 700px
 
 Each of the bridges has its own need in terms of configuration. Information for most is available on the Matterbridge wiki and can be accessed behind ``more information`` menu in the ``...`` menu. You can also `access the wiki directly. <https://github.com/42wim/matterbridge/wiki>`_
 
@@ -20,6 +21,7 @@ Lobby
 The lobby feature allows you to show guests a waiting screen until the call starts. This is ideal for webinars with external participants, for example.
 
 .. image:: images/lobby-in-talk.png
+    :width: 600px
 
 You can choose to let the participants join the call at a specific time, or when you dismiss the lobby manually.
 
@@ -35,6 +37,7 @@ Administrators can configure, enable and disable commands. Users can use the ``h
     ``/help``
 
 .. image:: images/command-help.png
+    :width: 600px
 
 Find more information in the `administrative documentation for Talk. <https://nextcloud-talk.readthedocs.io/en/stable/commands/>`_
 
@@ -44,16 +47,22 @@ 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.
 
 .. image:: images/join-chat.png
+    :width: 500px
+
+|
 
 .. image:: images/sidebar-chat.png
+    :width: 500px
 
 You can then chat or have a call with other participants, even when you start editing the file.
 
 .. image:: images/text-and-talk.png
+    :width: 700px
 
 In Talk, a conversation will be created for the file. You can chat from there, or go back to the file using the ``...`` menu in the top-right.
 
 .. image:: images/file-room.png
+    :width: 400px
 
 Create tasks from chat or share tasks in chat
 ---------------------------------------------
@@ -61,14 +70,22 @@ Create tasks from chat or share tasks in chat
 If Deck is installed, you can use the ``...`` menu of a chat message and turn the message into a Deck task.
 
 .. image:: images/deck-talk-create-card-menu.png
+    :width: 500px
+
+|
 
 .. image:: images/deck-talk-create-card-dialog.png
+    :width: 400px
 
 From within Deck, you can share tasks into chat conversations.
 
 .. image:: images/deck-talk-share-card-to-chat-menu.png
+    :width: 400px
+
+|
 
 .. image:: images/deck-talk-share-card-to-chat-in-talk.png
+    :width: 600px
 
 Breakout rooms
 --------------
@@ -82,6 +99,7 @@ To create breakout rooms, you need to be a moderator in a group conversation. Cl
 "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:
@@ -91,6 +109,7 @@ Here you'll be presented with 3 options:
 - **Allow participants choose**: Participants will be able to join breakout rooms themselves.
 
 .. image:: images/talk-breakout-rooms-setup-dialog.png
+    :width: 500px
 
 Manage breakout rooms
 ^^^^^^^^^^^^^^^^^^^^^
@@ -98,6 +117,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
+    :width: 500px
 
 From the sidebar header
 
@@ -106,11 +126,13 @@ From the sidebar header
 - **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
+    :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
+    :width: 400px
 
 Call recording
 --------------
@@ -131,16 +153,27 @@ 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
+    :width: 400px
+
+|
+
 .. image:: images/start-recording-in-call.png
+    :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
+    :width: 500px
 
 After stopping a recording, the server will take some time 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
+    :width: 300px
+
+|
+
 .. image:: images/shared-recordings.png
+    :width: 400px
 
 Recording consent
 ^^^^^^^^^^^^^^^^^
@@ -152,12 +185,18 @@ For compliance reasons with various privacy rights, it is possible to ask partic
 - 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
+    :width: 500px
 
 If recording consent is enabled, every participant, including moderators, will see a highlighted section in the "Media settings" before joining a call.
 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.png
+    :width: 500px
+
+|
+
 .. image:: images/give-recording-consent-checked.png
+    :width: 500px
 
 Federated conversation
 ----------------------
@@ -173,18 +212,19 @@ Send and accept invites
 The moderator of the conversation can send an invite to participant on a different server:
 
 .. image:: images/federation-invite-send.png
+   :width: 400px
 
 When receiving a notification, user will see a counter of pending invites above the conversations list.
 
 .. image:: images/federation-invite-pending.png
-   :width: 450px
+   :width: 400px
 
 Upon clicking it, more information will be provided about inviting party, and user can either accept or decline the invitation.
 
 .. image:: images/federation-invite-dialog.png
-   :width: 450px
+   :width: 500px
 
 By accepting the invite, conversation will appear in the list as any other one.
 
 .. image:: images/federation-conversations-list.png
-   :width: 450px
+   :width: 400px

user_manual/talk/join_a_call_or_chat_as_guest.rst

@@ -12,14 +12,17 @@ Joining a chat
 If you received a link to a chat conversation, you can open it in your browser to join the chat. Here, you will be prompted to enter your name before joining.
 
 .. image:: images/guest-view.png
+    :width: 400px
 
 You can also change your name later by clicking the ``Edit`` button, located top-right.
 
 .. image:: images/change-name.png
+    :width: 400px
 
 Your camera and microphone settings can be found in the ``Settings`` menu. There you can also find a list of shortcuts you can use.
 
 .. image:: images/guest-settings.png
+    :width: 600px
 
 Joining a call
 --------------
@@ -27,15 +30,17 @@ Joining a call
 You can start a call any time with the ``Start call`` button. Other participants will get notified and can join the call. If somebody else has started a call already, the button will change in a green ``Join call`` button.
 
 .. image:: images/join-call.png
+    :width: 600px
 
 Before actually joining the call you will see a device check, where you can pick the right camera and microphone, enable background blur or even join with any devices.
 
 .. image:: images/device-settings-before-call.png
-    :width: 300px
+    :width: 400px
 
 During a call, you can find the Camera and Microphone settings in the ``...`` menu in the top bar.
 
-.. image:: images/call-menu.png
+.. image:: images/guest-call-menu.png
+    :width: 300px
 
 During a call, you can mute your microphone and disable your video with the buttons in the top-right, or using the shortcuts ``M`` to mute audio and ``V`` to disable video. You can also use the ``space bar`` to toggle mute. When you are muted, pressing space will unmute you so you can speak until you let go of the space bar. If you are unmuted, pressing space will mute you until you let go.
 
@@ -52,3 +57,4 @@ More settings
 In the conversation menu you can choose to go full-screen. You can also do this by using the ``F`` key on your keyboard. In the conversation settings, you can find notification options and the full conversation description.
 
 .. image:: images/guest-room-menu.png
+    :width: 500px

user_manual/talk/talk_basics.rst

@@ -22,7 +22,7 @@ You can create a direct, one-on-one chat by searching for the name of a user, a
 If you want to create a custom group conversation, click the button next to the search field and filters button and then on ``Create a new conversation``.
 
 .. image:: images/create-new-conversation.png
-    :width: 300px
+    :width: 400px
 
 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.
 
@@ -37,6 +37,7 @@ In the second step, you get to add participants and finalize the creation of the
 After confirmation you will be redirected to the new conversation and can start communicating right away.
 
 .. image:: images/new-room.png
+    :width: 700px
 
 View all open conversations
 ---------------------------
@@ -44,7 +45,7 @@ View all open conversations
 You can view all the conversations that you can join by clicking the button next to the search field and filters button and then on ``Join open conversations.``
 
 .. image:: images/join-open-conversations.png
-    :width: 500px
+    :width: 400px
 
 Filter your conversations
 -------------------------
@@ -54,12 +55,12 @@ You can filter your conversations using the filter button located next to the se
 2. Filter unread messages: This option allows you to view all unread messages in all joined conversations.
 
 .. image:: images/filters-menu.png
-    :width: 250px
+    :width: 400px
 
 You can then clear the filter from the filters menu.
 
 .. image:: images/clear-filter.png
-    :width: 250px
+    :width: 400px
 
 Sharing files in a chat
 -----------------------
@@ -69,6 +70,7 @@ You can share files in a chat in 3 ways.
 First, you can simply drag'n'drop them on the chat.
 
 .. image:: images/drag-and-drop.png
+   :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.
 
@@ -76,7 +78,7 @@ Second, you can select a file from your Nextcloud Files or a file manager by cho
    :width: 500px
 
 .. image:: images/share-files-in-chat-selection.png
-    :width: 450px
+    :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.
 
@@ -86,6 +88,7 @@ You can add more files until you are done and decide to share the files. You can
 All users will be able to click the files to view, edit or download them, irrespective of them having a user 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
+   :width: 600px
 
 Inserting emoji
 ---------------
@@ -93,7 +96,7 @@ Inserting emoji
 You can add emoji using the picker on the left of the text input field.
 
 .. image:: images/emoji-picker.png
-   :width: 450px
+   :width: 400px
 
 Editing messages
 ----------------
@@ -101,7 +104,7 @@ Editing messages
 You can edit messages and captions to file shares up to 6 hours after sending.
 
 .. image:: images/message-editing.png
-   :width: 450px
+   :width: 600px
 
 Using Markdown
 ---------------
@@ -177,12 +180,12 @@ Setting reminder on messages
 You can set reminders on specific messages. If there's an important message you want to be notified about later, simply hover over it and click on the reminder icon.
 
 .. image:: images/set-message-reminder.png
-   :width: 450px
+   :width: 400px
 
 In the submenu, you can select an appropriate time to receive a notification later.
 
 .. image:: images/configure-message-reminder.png
-   :width: 450px
+   :width: 400px
 
 Replying to messages and more
 -----------------------------
@@ -190,12 +193,12 @@ Replying to messages and more
 You can reply to a message using the arrow that appears when you hover a message.
 
 .. image:: images/reply.png
-   :width: 450px
+   :width: 600px
 
 In the ``...`` menu you can also choose to reply privately. This will open a one-on-one chat.
 
 .. image:: images/chat-message-menu.png
-   :width: 450px
+   :width: 600px
 
 Here you can also create a direct link to the message or mark it unread so you will scroll back there next time you enter the chat. When it is a file, you can view the file in Files.
 
@@ -206,7 +209,7 @@ If you don't want to disturb anyone in the middle of the night, there is a silen
 While it is enabled, other participants will not receive notifications from your messages.
 
 .. image:: images/message-silent.png
-   :width: 450px
+   :width: 600px
 
 Managing a conversation
 -----------------------
@@ -216,16 +219,17 @@ You are always moderator in your new conversation. In the participant list you c
 Changing permissions of a user that joined a public conversation will also permanently add them to the conversation.
 
 .. image:: images/participant-menu.png
+    :width: 400px
 
 Moderators can configure the conversation. Select ``Conversation settings`` from the ``...`` menu of the conversation on the top to access the settings.
 
 .. image:: images/open-settings.png
-    :width: 300px
+    :width: 400px
 
 Here you can configure the description, guest access, if the conversation is visible to others on the server and more.
 
 .. image:: images/conversation-settings-dialog.png
-   :width: 450px
+   :width: 600px
 
 Messages expiration
 -------------------
@@ -234,6 +238,7 @@ A moderator can configure message expiration under the ``Conversation settings``
 The available expiration durations are 1 hour, 8 hours, 1 day, 1 week, 4 weeks, or never (which is the default setting).
 
 .. image:: images/messages-expiration.png
+   :width: 500px
 
 
 Starting a call
@@ -242,11 +247,12 @@ Starting a call
 When you're in a conversation, you can start a call any time with the ``Start call`` button. Other participants will get notified and can join the call.
 
 .. image:: images/device-settings-before-call.png
-    :width: 300px
+    :width: 400px
 
 If somebody else has started a call already, the button will change in a green ``Join call`` button.
 
 .. image:: images/join-call.png
+    :width: 600px
 
 During a call, you can mute your microphone and disable your video with the buttons on the right side of the top bar, or using the shortcuts ``M`` to mute audio and ``V`` to disable video. You can also use the space bar to toggle mute. When you are muted, pressing space will unmute you so you can speak until you let go of the space bar. If you are unmuted, pressing space will mute you until you let go.
 
@@ -260,11 +266,12 @@ You can access your settings and choose a different webcam, microphone and other
 From media settings dialog, you can also change the background of your video.
 
 .. image:: images/background-settings-in-call.png
-    :width: 300px
+    :width: 400px
 
 You can change other settings in the ``Talk settings`` dialog.
 
 .. image:: images/talk-settings.png
+    :width: 600px
 
 Starting a screen share
 -----------------------
@@ -273,6 +280,7 @@ You can click the monitor icon on your video stream to share your screen. Depend
 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
+    :width: 700px
 
 Changing view in a call
 -----------------------
@@ -280,11 +288,12 @@ Changing view in a call
 You can switch the view in a call with the little four-block icon in the top-right between promoted-view and grid view. The grid view will show everyone equally big and if the people do not fit on the screen, buttons will appear on the left and right that let you navigate.
 
 .. image:: images/talk-grid-view.png
+    :width: 700px
 
 The promoted view shows the speaker large and others in a row below. If the people do not fit on the screen, buttons will appear on the left and right that let you navigate.
 
 .. image:: images/talk-promoted-view.png
-
+    :width: 700px