From f572bf6c671ae406d8aa68ea9d07f30b4f7ad5d6 Mon Sep 17 00:00:00 2001 From: "Carrie Warner (Mattermost)" <74422101+cwarnermm@users.noreply.github.com> Date: Wed, 11 Sep 2024 14:54:27 -0400 Subject: [PATCH 1/6] Calls updates for v10 --- source/collaborate/make-calls.rst | 2 +- source/configure/calls-deployment.rst | 10 ++++------ source/configure/reporting-configuration-settings.rst | 7 +++---- 3 files changed, 8 insertions(+), 11 deletions(-) diff --git a/source/collaborate/make-calls.rst b/source/collaborate/make-calls.rst index fec3220378d..a091be7f348 100644 --- a/source/collaborate/make-calls.rst +++ b/source/collaborate/make-calls.rst @@ -286,7 +286,7 @@ You can access and share debug logs from **Account screen > Settings > Report a Call stats dump ~~~~~~~~~~~~~~~ -In cases where there are audio/video issues, difficulty in hearing other participants, and/or stuttering video and/or choppy audio, run the ``/call stats`` slash command in the channel where the call is currently active. This returns a JSON object via an ephemeral message. +In cases where there are audio/video issues, difficulty in hearing other participants, and/or stuttering video and/or choppy audio, run the ``/call stats`` slash command in the channel where the call is currently active. This returns a JSON object via an ephemeral message. Additionally, run the ``/call logs`` command to review the client logs for the last call session. You can run this command in an active call or after leaving the call in question. However, we will only save data for the last joined call so joining again will delete the previous call's feedback. diff --git a/source/configure/calls-deployment.rst b/source/configure/calls-deployment.rst index 130bb42d1ab..cf5b186603b 100644 --- a/source/configure/calls-deployment.rst +++ b/source/configure/calls-deployment.rst @@ -64,12 +64,10 @@ Network Limitations ----------- -- In Mattermost Cloud, up to 50 participants per channel can join a call. -- In Mattermost self-hosted deployments, the default maximum number of participants is unlimited; however, we recommend a maximum of 50 participants per call. Maximum call participants is configurable by going to **System Console > Plugin Management > Calls > Max call participants**. Call participant limits greatly depends on instance resources. For more details, refer to the :ref:`performance section ` below. - -.. note:: - - We recommend that Enterprise self-hosted customers looking for group calls beyond 50 concurrent users consider using the external, dedicated, and scalable rtcd service. See the :doc:`self-hosted calls deployment ` documentation for details. +- All Mattermost customers can start, join, and participate in 1:1 audio calls with optional screen sharing. +- For group calls up to 50 concurrent users, Mattermost Enterprise, Professional, or Mattermost Cloud is required. +- Enterprise customers can also `record calls <#record-a-call>`__, enable :ref:`live text captions ` during calls, and `transcribe recorded calls <#transcribe-recorded-calls>`__. We recommend that Enterprise self-hosted customers looking for group calls beyond 50 concurrent users consider using the :ref:`dedicated rtcd service `. +- For Mattermost self-hosted deployments, System admins need to enable and configure the plugin :ref:`using the System Console `. The default maximum number of participants is unlimited; however, we recommend a maximum of 50 participants per call. Maximum call participants is configurable by going to **System Console > Plugin Management > Calls > Max call participants**. Call participant limits greatly depends on instance resources. For more details, refer to the :ref:`performance section ` below. Configuration ------------- diff --git a/source/configure/reporting-configuration-settings.rst b/source/configure/reporting-configuration-settings.rst index 5ba1a86c6db..67d1e46909b 100644 --- a/source/configure/reporting-configuration-settings.rst +++ b/source/configure/reporting-configuration-settings.rst @@ -21,10 +21,9 @@ Site statistics +----------------------------------------------------------------+-------------------------------------------------------------+ | View statistics on a wide variety of activities in Mattermost, | - System Config path: **Reporting > Site Statistics** | -| including: activated users, seats, teams, channels, posts, | - ``config.json setting``: N/A | -| sessions, commands, webhooks, daily and monthly active users, | - Environment variable: N/A | -| websocket and database connections, collaborative playbooks, | | -| and calls. | | +| including: users, seats, teams, channels, posts, calls, | - ``config.json setting``: N/A | +| sessions, commands, webhooks, websocket and database | - Environment variable: N/A | +| connections, and collaborative playbooks, | | +----------------------------------------------------------------+-------------------------------------------------------------+ | **Notes**: | | | From fd06394139aac953f08b76b3ad6c41ffb7b396ba Mon Sep 17 00:00:00 2001 From: "Carrie Warner (Mattermost)" <74422101+cwarnermm@users.noreply.github.com> Date: Thu, 12 Sep 2024 10:09:20 -0400 Subject: [PATCH 2/6] Simplification for preferences & Calls pref --- source/collaborate/make-calls.rst | 4 +-- source/guides/preferences.rst | 2 ++ .../customize-your-channel-sidebar.rst | 2 +- source/preferences/customize-your-theme.rst | 17 ++++++++-- .../preferences/manage-advanced-options.rst | 2 +- .../manage-your-calls-preferences.rst | 14 ++++++++ .../manage-your-display-options.rst | 32 +++++++------------ .../manage-your-sidebar-options.rst | 8 ++--- 8 files changed, 49 insertions(+), 32 deletions(-) create mode 100644 source/preferences/manage-your-calls-preferences.rst diff --git a/source/collaborate/make-calls.rst b/source/collaborate/make-calls.rst index a091be7f348..4af73ccbd92 100644 --- a/source/collaborate/make-calls.rst +++ b/source/collaborate/make-calls.rst @@ -225,7 +225,7 @@ Troubleshooting My audio doesn't work when I join a call ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -If you can hear the other participants in the call but they can't hear you, select the horizontal dots next to the call end button in the widget. From there, you can check and change your audio output and microphone settings. Select the horizontal dots again to close the menu. +If you can hear the other participants in the call but they can't hear you, select the Gear icon |gear| next to the call end button in the widget. From there, you can check and change your audio output and microphone settings. Select |gear| again to close the menu. Alternatively, you can :doc:`manage your audio and microphone preferences ` in **Settings**. My call is disconnected after a few seconds ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -244,7 +244,7 @@ There's a known bug on macOS with some versions of Chrome (which is used by Matt 5. Select **Screen share** and give it permissions again. 6. Restart Mattermost again. -If the issue persists please post in the public calls channel. +If the issue persists please post on the Mattermost Community Server in the `Developer: Calls `_ channel to troubleshoot further. Debugging --------- diff --git a/source/guides/preferences.rst b/source/guides/preferences.rst index 0eaa6e006ea..fc62d1c56d4 100644 --- a/source/guides/preferences.rst +++ b/source/guides/preferences.rst @@ -26,6 +26,7 @@ Learn more Manage your display options Manage your sidebar options Manage advanced options + Manage your calls preferences Customize your desktop app experience Connect to multiple workspaces @@ -38,5 +39,6 @@ Learn more * :doc:`Customize your display options ` - Customize your Mattermost display to suit your preferences. * :doc:`Manage your sidebar options ` - Customize your Mattermost channel sidebar to suit your preferences. * :doc:`Manage advanced options ` - Customize advanced Mattermost user options to suit your preferences. +* :doc:`Manage your calls preferences ` - Custome Mattermost Calls to suit your preferences. * :doc:`Customize your desktop app experience ` - Learn about additional preferences available only in the desktop app. * :doc:`Connect to multiple Mattermost workspaces ` - Learn how to connect to multiple Mattermost workspaces using the Mattermost desktop or mobile app. \ No newline at end of file diff --git a/source/preferences/customize-your-channel-sidebar.rst b/source/preferences/customize-your-channel-sidebar.rst index 23bbff7ba8c..819299497f7 100644 --- a/source/preferences/customize-your-channel-sidebar.rst +++ b/source/preferences/customize-your-channel-sidebar.rst @@ -4,7 +4,7 @@ Customize your channel sidebar .. include:: ../_static/badges/allplans-cloud-selfhosted.rst :start-after: :nosearch: -Conversations in Mattermost are crucial to company productivity and success. Keeping conversations organized in the sidebar creates an efficient workplace. You can customize your own channel sidebar in a browser or using the desktop app based on how you use Mattermost. Customizations you make are only visible to you, are visible when using the mobile app, and won't affect what your teammates see in their sidebars. +Conversations in Mattermost are crucial to company productivity and success. Keeping conversations organized in the sidebar creates an efficient workplace. You can customize your own channel sidebar based on how you prefer to use Mattermost within a web browser or using the desktop app. Customizations you make are only visible to you, are visible when using the mobile app, and won't affect what your teammates see in their sidebars. Here's how your sidebar is set up by default: diff --git a/source/preferences/customize-your-theme.rst b/source/preferences/customize-your-theme.rst index 2b3b7329bc5..3a945ef12b4 100644 --- a/source/preferences/customize-your-theme.rst +++ b/source/preferences/customize-your-theme.rst @@ -16,13 +16,24 @@ To customize your Mattermost theme: .. tab:: Web/desktop - Select the **Settings** |gear| icon, then go to **Display > Theme**. Select **Theme Colors** to choose from five standard themes designed by the Mattermost team. + Select the **Settings** |gear| icon, then go to **Display > Theme**. Select **Theme Colors** to choose from five standard themes designed by the Mattermost team. - Using Mattermost in a browser or the desktop app, you can customize a standard theme further to truly make it your own. After selecting a standard theme, select **Custom Theme** and modify your color choices based on your preferences. See the `custom themes <#custom-themes>`__ documentation to learn what's configurable, and see the `custom theme examples <#custom-theme-examples>`__ documentation for inspiration. + You can customize a standard theme further to truly make it your own. After selecting a standard theme, select **Custom Theme** and modify your color choices based on your preferences. See the `custom themes <#custom-themes>`__ documentation to learn what's configurable, and see the `custom theme examples <#custom-theme-examples>`__ documentation for inspiration. .. tab:: Mobile - Tap your profile picture, and select **Settings**, then go to **Display > Theme**. + Tap **Theme** to select one of 5 standard Mattermost themes. + + .. note:: + + You can define a custom theme using Mattermost in a web browser or the desktop app. + +Import a Slack theme +-------------------- + +Using Mattermost in a web browser or the desktop app, you can select **Import theme colors from Slack** to import a Slack theme. + +In Slack, go to **Preferences > Sidebar Theme** and open the custom theme option. From there, copy the theme color vector and then paste it into the **Input Slack Theme** input box in Mattermost. Any theme settings that are not customizable in Slack will default to the “Sapphire” standard theme settings. Custom themes ------------- diff --git a/source/preferences/manage-advanced-options.rst b/source/preferences/manage-advanced-options.rst index eefbbc62a55..2f590e8d7e5 100644 --- a/source/preferences/manage-advanced-options.rst +++ b/source/preferences/manage-advanced-options.rst @@ -4,7 +4,7 @@ Manage advanced options .. include:: ../_static/badges/allplans-cloud-selfhosted.rst :start-after: :nosearch: -To customize Mattermost display options based on your preferences, select the gear icon |gear| next to your profile picture, then go to **Advanced**. +Using Mattermost in a web browser or the desktop app, you can customize advanced Mattermost options based on your preferences. Select the gear icon |gear| next to your profile picture, then select **Advanced**. Send messages on CTRL/⌘+ENTER ------------------------------ diff --git a/source/preferences/manage-your-calls-preferences.rst b/source/preferences/manage-your-calls-preferences.rst new file mode 100644 index 00000000000..91b5fe1040a --- /dev/null +++ b/source/preferences/manage-your-calls-preferences.rst @@ -0,0 +1,14 @@ +Manage your Calls preferences +============================== + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +Using Mattermost in a web browser or the desktop app, you can customize Mattermost Calls based on your preferences. Select the gear icon |gear| next to your profile picture, then select **Calls**. + +Audio devices +------------- + +1. Select **Edit**. +2. Choose the microphone and speaker output used for Mattermost Calls +3. Select **Save**. \ No newline at end of file diff --git a/source/preferences/manage-your-display-options.rst b/source/preferences/manage-your-display-options.rst index 7b750b9ead2..d7c57a2f8bb 100644 --- a/source/preferences/manage-your-display-options.rst +++ b/source/preferences/manage-your-display-options.rst @@ -4,37 +4,27 @@ Manage your display options .. include:: ../_static/badges/allplans-cloud-selfhosted.rst :start-after: :nosearch: -To customize Mattermost display options based on your preferences, select the gear icon |gear| next to your profile picture, then go to **Display**. +You can customize Mattermost display options based on your preferences. + +- Using Mattermost in a web browser or the desktop app, select the gear icon |gear| next to your profile picture, then go to **Display**. +- On the Mattermost mobile app, tap your profile picture, and then tap **Settings > Display**. Theme ----- .. tab:: Web/Desktop - Select **Theme** to apply a different look and feel to your Mattermost screen. + Select **Theme** to apply a different look and feel to Mattermost. Select **Theme Colors** to select one of 5 standard themes designed by the Mattermost team. Or, select **Custom Theme** to customize a standard theme even further. .. tab:: Mobile - Access **Settings** by tapping on your profile picture. Then, tap **Display** and **Theme**. - -Customize a theme ------------------ - -Using Mattermost in a web browser or the desktop app, you can customize any of the standard themes by selecting a standard theme and then selecting **Custom Theme** to load the standard theme into the custom theme color selectors. - -Select **Custom Theme** to customize your theme colors and share them with others by copying and pasting theme vectors into the input box. Observe a live preview as you customize theme colors, then select **Save** to confirm your changes. Discard your changes by selecting **Cancel**, or by exiting the settings modal and selecting **Yes, Discard**. See the :doc:`customize your theme ` documentation to learn more about working with the custom theme color selectors. - -.. tip:: - In Enterprise edition, if you are a member of multiple teams, you can optionally select the checkbox **Apply new theme to all my teams** to have the theme show up across teams. Otherwise, the changes will only apply to the current team. - -Import a Slack theme -~~~~~~~~~~~~~~~~~~~~ + Tap **Theme** to select one of 5 standard Mattermost themes. -Using Mattermost in a web browser or the desktop app, you can select **Import theme colors from Slack** to import a Slack theme. + .. note:: -In Slack, go to **Preferences > Sidebar Theme** and open the custom theme option. From there, copy the theme color vector and then paste it into the **Input Slack Theme** input box in Mattermost. Any theme settings that are not customizable in Slack will default to the “Sapphire” standard theme settings. + You can define a custom theme using Mattermost in a web browser or the desktop app. Threaded discussions --------------------- @@ -49,7 +39,7 @@ Depending on how your system admin has :ref:`configured threaded discussions `, including custom, collapsible channel categories, drag and drop, unread filtering, channel sorting options, and more. .. note:: - - The following sidebar settings apply to your current sidebar only. - - You must manage sidebar settings individually for every team you're a member of. - - You can manage these settings in a web browser or the desktop app. You can't manage these channel sidebar settings using the Mattermost mobile app. + - The following sidebar settings apply to your current sidebar only. + - You must manage sidebar settings individually for every team you're a member of. + - You can manage these settings in a web browser or the desktop app. You can't manage these channel sidebar settings using the Mattermost mobile app. Group unread channels separately -------------------------------- From b4dbda4f9d644feb1f72b5f4343fc499ca117051 Mon Sep 17 00:00:00 2001 From: "Carrie Warner (Mattermost)" <74422101+cwarnermm@users.noreply.github.com> Date: Fri, 13 Sep 2024 14:53:15 -0400 Subject: [PATCH 3/6] Editorial updates --- source/preferences/customize-your-channel-sidebar.rst | 2 +- source/preferences/manage-your-calls-preferences.rst | 2 +- source/preferences/manage-your-display-options.rst | 4 +++- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/source/preferences/customize-your-channel-sidebar.rst b/source/preferences/customize-your-channel-sidebar.rst index 819299497f7..e07db164850 100644 --- a/source/preferences/customize-your-channel-sidebar.rst +++ b/source/preferences/customize-your-channel-sidebar.rst @@ -4,7 +4,7 @@ Customize your channel sidebar .. include:: ../_static/badges/allplans-cloud-selfhosted.rst :start-after: :nosearch: -Conversations in Mattermost are crucial to company productivity and success. Keeping conversations organized in the sidebar creates an efficient workplace. You can customize your own channel sidebar based on how you prefer to use Mattermost within a web browser or using the desktop app. Customizations you make are only visible to you, are visible when using the mobile app, and won't affect what your teammates see in their sidebars. +Conversations in Mattermost are crucial to company productivity and success. Keeping conversations organized in the sidebar creates an efficient workplace. Using a web browser or the desktop app, you can customize your own channel sidebar based on how you prefer to use Mattermost. Customizations you make are only visible to you, are visible when using the mobile app, and won't affect what your teammates see in their sidebars. Here's how your sidebar is set up by default: diff --git a/source/preferences/manage-your-calls-preferences.rst b/source/preferences/manage-your-calls-preferences.rst index 91b5fe1040a..958447c10b3 100644 --- a/source/preferences/manage-your-calls-preferences.rst +++ b/source/preferences/manage-your-calls-preferences.rst @@ -10,5 +10,5 @@ Audio devices ------------- 1. Select **Edit**. -2. Choose the microphone and speaker output used for Mattermost Calls +2. Choose the microphone and speaker output used for Mattermost Calls. 3. Select **Save**. \ No newline at end of file diff --git a/source/preferences/manage-your-display-options.rst b/source/preferences/manage-your-display-options.rst index d7c57a2f8bb..98a5a2b8d5e 100644 --- a/source/preferences/manage-your-display-options.rst +++ b/source/preferences/manage-your-display-options.rst @@ -18,13 +18,15 @@ Theme Select **Theme Colors** to select one of 5 standard themes designed by the Mattermost team. Or, select **Custom Theme** to customize a standard theme even further. + See the :doc:`customize your theme `` documentation for more information. + .. tab:: Mobile Tap **Theme** to select one of 5 standard Mattermost themes. .. note:: - You can define a custom theme using Mattermost in a web browser or the desktop app. + You can define a custom theme using Mattermost in a web browser or the desktop app. See the :doc:`customize your theme `` documentation for more information. Threaded discussions --------------------- From 0cbff41eb2d3d336730940942f799b3413dc19e3 Mon Sep 17 00:00:00 2001 From: "Carrie Warner (Mattermost)" <74422101+cwarnermm@users.noreply.github.com> Date: Fri, 13 Sep 2024 15:01:24 -0400 Subject: [PATCH 4/6] Update source/preferences/customize-your-channel-sidebar.rst --- source/preferences/customize-your-channel-sidebar.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/preferences/customize-your-channel-sidebar.rst b/source/preferences/customize-your-channel-sidebar.rst index e07db164850..d191e06d42e 100644 --- a/source/preferences/customize-your-channel-sidebar.rst +++ b/source/preferences/customize-your-channel-sidebar.rst @@ -4,7 +4,7 @@ Customize your channel sidebar .. include:: ../_static/badges/allplans-cloud-selfhosted.rst :start-after: :nosearch: -Conversations in Mattermost are crucial to company productivity and success. Keeping conversations organized in the sidebar creates an efficient workplace. Using a web browser or the desktop app, you can customize your own channel sidebar based on how you prefer to use Mattermost. Customizations you make are only visible to you, are visible when using the mobile app, and won't affect what your teammates see in their sidebars. +Conversations in Mattermost are crucial to company productivity and success. Keeping conversations organized in the sidebar creates an efficient workplace. Using a web browser or the desktop app, you can customize your own channel sidebar based on how you prefer to use Mattermost. Customizations you make are only visible to you, are visible when using the mobile app, and won't affect what your teammates see in their sidebars. Here's how your sidebar is set up by default: From 2f76f9d01b903c0c452a89049b91234ba7745a9e Mon Sep 17 00:00:00 2001 From: "Carrie Warner (Mattermost)" <74422101+cwarnermm@users.noreply.github.com> Date: Fri, 13 Sep 2024 15:02:09 -0400 Subject: [PATCH 5/6] Update source/preferences/manage-your-display-options.rst --- source/preferences/manage-your-display-options.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/preferences/manage-your-display-options.rst b/source/preferences/manage-your-display-options.rst index 98a5a2b8d5e..0e16cc71703 100644 --- a/source/preferences/manage-your-display-options.rst +++ b/source/preferences/manage-your-display-options.rst @@ -26,7 +26,7 @@ Theme .. note:: - You can define a custom theme using Mattermost in a web browser or the desktop app. See the :doc:`customize your theme `` documentation for more information. + You can define a custom theme using Mattermost in a web browser or the desktop app. See the :doc:`customize your theme ` documentation for more information. Threaded discussions --------------------- From 6273217edb34534f9341c520a9ef09f7e00905ed Mon Sep 17 00:00:00 2001 From: "Carrie Warner (Mattermost)" <74422101+cwarnermm@users.noreply.github.com> Date: Fri, 13 Sep 2024 15:02:48 -0400 Subject: [PATCH 6/6] Update source/preferences/manage-your-display-options.rst --- source/preferences/manage-your-display-options.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/preferences/manage-your-display-options.rst b/source/preferences/manage-your-display-options.rst index 0e16cc71703..93a0381683b 100644 --- a/source/preferences/manage-your-display-options.rst +++ b/source/preferences/manage-your-display-options.rst @@ -18,7 +18,7 @@ Theme Select **Theme Colors** to select one of 5 standard themes designed by the Mattermost team. Or, select **Custom Theme** to customize a standard theme even further. - See the :doc:`customize your theme `` documentation for more information. + See the :doc:`customize your theme ` documentation for more information. .. tab:: Mobile