Simplification for preferences & Calls pref

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 </preferences/manage-your-calls-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 <https://community.mattermost.com/core/channels/developers-channel-call>`_ channel to troubleshoot further.
 
 Debugging
 ---------

source/guides/preferences.rst

@@ -26,6 +26,7 @@ Learn more
   Manage your display options </preferences/manage-your-display-options>
   Manage your sidebar options </preferences/manage-your-sidebar-options>
   Manage advanced options </preferences/manage-advanced-options>
+  Manage your calls preferences </preferences/manage-your-calls-preferences>
   Customize your desktop app experience </preferences/customize-desktop-app-experience>
   Connect to multiple workspaces </preferences/connect-multiple-workspaces>
 
@@ -38,5 +39,6 @@ Learn more
 * :doc:`Customize your display options </preferences/manage-your-display-options>` - Customize your Mattermost display to suit your preferences.
 * :doc:`Manage your sidebar options </preferences/manage-your-sidebar-options>` - Customize your Mattermost channel sidebar to suit your preferences.
 * :doc:`Manage advanced options </preferences/manage-advanced-options>` - Customize advanced Mattermost user options to suit your preferences.
+* :doc:`Manage your calls preferences </preferences/manage-your-calls-preferences>` - Custome Mattermost Calls to suit your preferences.
 * :doc:`Customize your desktop app experience </preferences/customize-desktop-app-experience>` - Learn about additional preferences available only in the desktop app.
 * :doc:`Connect to multiple Mattermost workspaces </preferences/connect-multiple-workspaces>` - Learn how to connect to multiple Mattermost workspaces using the Mattermost desktop or mobile app.

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:
 

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

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

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

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 </preferences/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 <co
 
 .. tab:: Mobile
 
-    Access **Settings** by tapping on your profile picture. Then, tap **Display** and **Threaded discussions**.
+    Tap **Threaded discussions** to manage this option.
 
 Clock display
 -------------
@@ -62,7 +52,7 @@ You can customize how time is displayed in Mattermost.
 
 .. tab:: Mobile
 
-    Access **Settings** by tapping on your profile picture. Then, tap **Display** and **Clock Display**.
+    Tap **Clock Display** to display time in Mattermost using a 12-hour or 24-hour convention.
 
 Teammate name display
 ---------------------
@@ -114,7 +104,7 @@ You can customize the timezone used for timestamps in Mattermost and in email no
 
 .. tab:: Mobile
 
-    Access **Settings** by tapping on your profile picture. Then, tap **Display** and **Timezone**.
+    Tap **Timezone** to set your timezone automatically based on your mobile device preference.
 
 Website link previews
 ---------------------

source/preferences/manage-your-sidebar-options.rst

@@ -4,15 +4,15 @@ Manage your sidebar options
 .. include:: ../_static/badges/allplans-cloud-selfhosted.rst
   :start-after: :nosearch:
 
-To customize Mattermost channel sidebar options based on your preferences, select the gear icon |gear| next to your profile picture, then go to **Sidebar**.
+Using Mattermost in a web browser or the desktop app, you can customize your Mattermost sidebar based on your preferences. Select the gear icon |gear| next to your profile picture, then select **Sidebar**.
 
 Your channel sidebar includes :doc:`enhanced sidebar features </preferences/customize-your-channel-sidebar>`, 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
 --------------------------------