Added channel banner docs & new SKU badges

source/_static/badges/ent-adv-cloud-selfhosted.rst

@@ -0,0 +1,14 @@
+:orphan:
+:nosearch:
+
+.. raw:: html
+
+  <div class="mm-plans-badge">
+
+|plans-img| Available on `Enterprise Advanced plans <https://mattermost.com/pricing/>`__
+
+|deployment-img| `Cloud <https://mattermost.com/sign-up/>`__ and `self-hosted <https://mattermost.com/download/>`__ deployments
+
+.. raw:: html
+
+  </div>

source/_static/badges/ent-adv-only.md

@@ -0,0 +1,9 @@
+```{raw} html
+<div class="mm-plans-badge">
+```
+
+![plans-img](/_static/images/badges/flag_icon.svg) Available only on [Enterprise Advanced](https://mattermost.com/pricing/) plans
+
+```{raw} html
+</div>
+```

source/_static/badges/ent-adv-only.rst

@@ -0,0 +1,16 @@
+:orphan:
+:nosearch:
+
+.. If used with include::, note the paths for images
+
+.. raw:: html
+
+  <div class="mm-badge mm-badge--note">
+
+Note
+
+|plans-img-yellow| Available only on `Enterprise Advanced <https://mattermost.com/pricing/>`__ plans
+
+.. raw:: html
+
+  </div>

source/collaborate/collaborate-within-channels.rst

@@ -35,6 +35,7 @@ Learn more about collaborating within Mattermost channels:
   Communicate a channel's focus and scope </collaborate/channel-header-purpose>
   Create channels </collaborate/create-channels>
   Rename channels </collaborate/rename-channels>
+  Display channel banners </collaborate/display-channel-banners>
   Convert public channels to private channels </collaborate/convert-public-channels>
   Convert group messages to private channels </collaborate/convert-group-messages>
   Join and leave channels </collaborate/join-leave-channels>
@@ -55,6 +56,7 @@ Learn more about collaborating within Mattermost channels:
 * :doc:`Navigate between channels </collaborate/navigate-between-channels>` - Learn how to navigate between channels.
 * :doc:`Create channels </collaborate/create-channels>`  - Create channels to organize discussion by topic, project, or focus.
 * :doc:`Rename a channel </collaborate/rename-channels>` - Rename channels to make them more discoverable.
+* :doc:`Display channel banners </collaborate/display-channel-banners>` - Display a fixed banner at the top of channels to warn users about the presence of classified or sensitive information.
 * :doc:`Convert public channels to private channels </collaborate/convert-public-channels>` - Learn how to convert channel access and visibility.
 * :doc:`Convert group messages to private channels </collaborate/convert-group-messages>` - Learn how to convert group messages to private channels.
 * :doc:`Manage channel members </collaborate/manage-channel-members>` - Add and remove users from channels.

source/collaborate/display-channel-banners.rst

@@ -0,0 +1,38 @@
+Display channel headers
+=======================
+
+.. include:: ../_static/badges/ent-adv-cloud-selfhosted.rst
+  :start-after: :nosearch:
+
+From Mattermost v10.9, users with admin permissions can enable channel banners to remind channel members about being diligent to avoid data spillage in channels that aren't intended for classified or sensitive information. These non-dismissible banners can be styled using Markdown and are visible across all Mattermost clients, including web browsers, the desktop app, and the mobile app.
+
+Channel banner use cases include the following:
+
+- Security classifications, such as **CONTROLLED UNCLASSIFIED: IMPACT LEVEL 5** with a distinctive color to alert members of the required security level.
+- Important notices, such as **Reminder: Code complete deadlines are Fridays at 3 PM**, for recurring reminders.
+- Policy or terms, such as  **All discussion in this channel is private and restricted** with a red color to signal caution.
+
+Mattermost :ref:`channel admins <collaborate/learn-about-roles:channel admin>`, :ref:`team admins <collaborate/learn-about-roles:team admin>`, and :ref:`system admins <collaborate/learn-about-roles:system admin>` can enable a banner with custom text at the top of Mattermost public or private channels. 
+
+Create a channel banner:
+
+1. Open a channel where you have administrative permissions.
+2. Select the channel name at the top of the center pane to access the drop-down menu, then select **Channel Settings**.
+3. Select **Configuration** and enable the **Channel Banner** option.
+4. Specify the banner text you want to display at the top of the channel. You can style the text using :ref:`Markdown <collaborate/format-messages:use markdown>`, if desired.
+5. Select the banner color.
+6. Select **Save** to apply the changes. The banner displays immediately.
+
+Change a channel banner
+------------------------
+
+You can change the banner text or color at any time by following the same steps above. The new banner text or color displays immediately.
+
+Remove a channel banner
+-------------------------
+
+Disable the **Channel Banner** option in the channel settings to remove the banner from the channel.
+
+.. tip::
+
+  System admins can grant any user the ability to create and manage channel banners by assigning the **Manage Channel Banners** permission in the System Console. See the :doc:`advanced permissions </onboard/advanced-permissions>` documentation for details.

source/onboard/advanced-permissions-backend-infrastructure.rst

@@ -236,6 +236,8 @@ Permissions in Mattermost are a property of the server code base and are not cre
 +----------------------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | order_bookmark_private_channel               | channel | Reorder bookmarks in a private channel.                                                                                                                                                               |
 +----------------------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| manage_channel_banner                        | channel | Manage channel banners.                                                                                                                                                                               |
++----------------------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 ``Roles`` field
 ~~~~~~~~~~~~~~~
@@ -284,6 +286,7 @@ The following built-in roles with default permissions are available:
 - edit_bookmark_private_channel
 - delete_bookmark_private_channel
 - order_bookmark_private_channel
+- manage_channel_banner
 
 *channel_guest*
 
@@ -456,6 +459,7 @@ The following built-in roles with default permissions are available:
 - edit_bookmark_private_channel
 - delete_bookmark_private_channel
 - order_bookmark_private_channel
+- manage_channel_banner
 
 *system_custom_group_admin*
 
@@ -636,6 +640,7 @@ The following built-in roles with default permissions are available:
 - edit_bookmark_private_channel
 - delete_bookmark_private_channel
 - order_bookmark_private_channel
+- manage_channel_banner
 
 *team_guest*