Skip to content

Commit 464c653

Browse files
authored
Doc'd new Channel Settings modal for creating/renaming channels (#8031)
1 parent 98057eb commit 464c653

File tree

3 files changed

+14
-15
lines changed

3 files changed

+14
-15
lines changed

source/collaborate/archive-unarchive-channels.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Delete :ref:`public channels <collaborate/channel-types:public channels>` and :r
1515

1616
.. tab:: Web/Desktop
1717

18-
To archive a channel, select the channel name at the top of the center pane to access the drop-down menu, then select **Archive Channel**.
18+
To archive a channel, select the channel name at the top of the center pane to access the drop-down menu, then select **Archive Channel**.
1919

2020
.. tab:: Mobile
2121

source/collaborate/channel-header-purpose.rst

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ Communicate a channel's focus and scope
44
.. include:: ../_static/badges/allplans-cloud-selfhosted.rst
55
:start-after: :nosearch:
66

7-
87
Every channel in Mattermost serves a purpose and exists for a reason. You can communicate a channel's focus and scope in 3 ways:
98

109
- a descriptive `channel name <#channel-name>`__
@@ -17,25 +16,25 @@ Channel name
1716
You're prompted to provide a channel name when :doc:`creating a new channel in Mattermost </collaborate/create-channels>`. Channel names must be at least 2 characters, and can be up to 64 characters in length. See the :doc:`channel naming conventions </collaborate/channel-naming-conventions>` documentation for additional details and guidance on why channel naming is important.
1817

1918
.. note::
20-
21-
`Some unicode characters <https://www.w3.org/TR/unicode-xml/#Charlist>`_ aren't supported in channel names.
19+
20+
`Some unicode characters <https://www.w3.org/TR/unicode-xml/#Charlist>`_ aren't supported in channel names.
2221

2322
Looking to rename an existing channel? See the :doc:`rename channels </collaborate/rename-channels>` documentation for details.
2423

2524
Channel purpose
2625
---------------
2726

28-
You're prompted to provide an optional channel purpose description when :doc:`creating a new channel in Mattermost </collaborate/create-channels>` visible when you select **View Info** |channel-info| for the channel. Any member of a channel can change a channel's purpose description, unless the system admin has :doc:`disabled the ability to do so </onboard/advanced-permissions>`.
27+
You're prompted to provide an optional channel purpose description when :doc:`creating a channel </collaborate/create-channels>` or :doc:`renaming a channel </collaborate/rename-channels>`. A channel purpose can be up to 250 characters in length, and is often used to help users decide whether to join that channel.
2928

30-
A channel purpose can be up to 250 characters in length, and is often used to help users decide whether to join that channel.
29+
A channel's purpose is visible in the right pane when you select the **View Info** |channel-info| icon for the channel. Any member of a channel can change a channel's purpose description, unless the system admin has :doc:`disabled the ability to do so </onboard/advanced-permissions>`.
3130

3231
.. tab:: Web/Desktop
3332

3433
.. image:: ../images/channel-purpose-info.png
3534
:alt: Channel purpose helps users decide if they want to join the channel based on its scope or focus.
3635

37-
1. Select a channel.
38-
2. Select the channel name and **Edit Channel Purpose** to provide or update a channel's purpose.
36+
1. Select the channel name at the top of the center pane to access the drop-down menu, then select **Channel Settings**.
37+
2. Enter or update the channel purpose.
3938
3. Select **Save**.
4039

4140
.. tab:: Mobile
@@ -73,14 +72,14 @@ A channel purpose can be up to 250 characters in length, and is often used to he
7372
Channel header
7473
--------------
7574

76-
A channel header refers to text that displays directly under a channel name at the top of the screen. Any channel member can change a channel header, unless the system admin has :doc:`disabled the ability to do so </onboard/advanced-permissions>`
75+
A channel header is text that displays directly under a channel name at the top of the channel. Any channel member can change a channel header, unless the system admin has :doc:`disabled the ability to do so </onboard/advanced-permissions>`
7776

7877
A channel header can be up to 1024 characters in length, include Markdown formatting, and is often used to summarize the channel's focus or to provide links to frequently accessed documents, tools, or websites.
7978

8079
.. tab:: Web/Desktop
8180

82-
1. Select a channel.
83-
2. Select the channel name and **Edit Channel Header**. You can use the same :ref:`Markdown formatting <collaborate/format-messages:use markdown>` in the channel header as you would when composing a message.
81+
1. Select the channel name at the top of the center pane to access the drop-down menu, then select **Channel Settings**.
82+
2. Enter or change channel header details. You can use the same :ref:`Markdown formatting <collaborate/format-messages:use markdown>` in the channel header as you would when composing a message.
8483

8584
.. image:: ../images/channel-header.png
8685
:alt: Channel headers can include links to documents, tools, or websites.

source/collaborate/rename-channels.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,12 @@ Anyone can rename the channels they belong to, unless the system admin has :doc:
88

99
.. tab:: Web/Desktop
1010

11-
Select the channel name at the top of the center pane to access the drop-down menu, then select **Rename Channel**. You'll be prompted to provide two pieces of information:
11+
Select the channel name at the top of the center pane to access the drop-down menu, then select **Channel Settings**. You'll be prompted to provide two pieces of information:
1212

13-
- **Channel display name:** This appears in the Mattermost user interface.
14-
- **Channel handle:** This is part of the channel URL. You can also change the channel handle when renaming a channel, but changing channel handles may break existing links.
13+
- **Channel name:** The channel name that displays in the Mattermost user interface for all users. Enter a different channel name if needed or preferred.
14+
- **Channel URL:** The web URL used to access the channel in a web browser. Select **Edit** to change the URL, and select **Done** to save your changes.
1515

16-
For example, for the following channel, ``https://community.mattermost.com/core/channels/ux-design``, The channel display name would be ``UX Design``, and the channel handle would be ``ux-design``.
16+
For example, a channel could be named ``UX Design`` and have a URL of ``https://community.mattermost.com/core/channels/ux-design``.
1717

1818
.. tab:: Mobile
1919

0 commit comments

Comments
 (0)