Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Moved actionable instructions to top of page; caveats to bottom #7661

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Moved actionable instructions to top of page; caveats to bottom #7661

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
23f3c56
Moved actionable instructions to top of page; caveats to bottom
cwarnermm Dec 13, 2024
0d53aab
Merge branch 'master' into above-the-fold
cwarnermm Jan 7, 2025
c9b62ed
Merge branch 'master' into above-the-fold
cwarnermm Jan 10, 2025
189626b
Merge branch 'master' into above-the-fold
cwarnermm Feb 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 10 additions & 18 deletions source/collaborate/browse-channels.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,27 @@ Browse channels
.. include:: ../_static/badges/allplans-cloud-selfhosted.rst
:start-after: :nosearch:

Browse available Mattermost channels you can join.

.. tab:: Web/Desktop

From Mattermost v9.1, filter the list of channels by public, private, or archived channels, and you can hide all channels you're already a member of.

1. Select the **Plus** |plus| icon at the top of the channel sidebar to see all available public channels you can join that you're not already a member of.
2. Select **Browse Channels**.
3. Search for channels by name or scroll through the list.
4. Select **Join** next to any channel to become a member of that channel.

.. tip::

From Mattermost v9.1, you can filter the list of channels by public, private, or archived channels, and you can hide all channels you're already a member of.
Want to see all of the channels you're already a member of, or can't find a specific private channel? Select **Find Channel** in the channel sidebar to see all of the channels you're currently a member of across all of your teams, including public and private channels, direct and group messages, channels with unread messages, and threads. Channels you have muted aren't included in results.

.. tab:: Mobile

.. tip::

You can filter the list of channels by public, archived, or shared channels.

1. Tap the **Plus** |plus| icon located in the top right corner of the app.

.. image:: ../images/mobile-select-a-channel.jpg
Expand All @@ -43,20 +51,4 @@ Browse channels

.. image:: ../images/mobile-browse-public-channels.jpg
:alt: Tap on the public channel name that you want to join.
:scale: 30

.. tip::

You can filter the list of channels by public, archived, or shared channels.

.. tip::

Want to see all of the channels you're already a member of, or can't find a specific private channel? Using a browser or the desktop app, select **Find Channel** in the channel sidebar to see all of the channels you're currently a member of across all of your teams, including public and private channels, direct and group messages, channels with unread messages, and threads. Channels you have muted aren't included in results.

Revisit recent channels
-----------------------

Using a browser or the desktop app, use the **History** arrows at the top of the sidebar to move back and forth through your channel history.

- Select the left arrow to go back one page.
- Select the right arrow to go forward one page.
:scale: 30
44 changes: 22 additions & 22 deletions source/collaborate/convert-group-messages.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,6 @@ Convert group messages to private channels

From Mattermost v9.1, you can change the members of your group conversation by converting the group message to a private channel. When a group message is converted to private, its history and membership are preserved. Membership in a private channel remains as invitation only.

.. note::

- Any member of an existing group message, except :doc:`guests </onboard/guest-accounts>`, can convert that group message to a private channel.
- Conversation history will be visible to all channel members.
- All group message participants must share at least one team membership.

.. tab:: Web/Desktop

1. Select the group message name at the top of the center pane to access the drop-down menu, then select **Convert to Private Channel**.
Expand All @@ -23,32 +17,38 @@ From Mattermost v9.1, you can change the members of your group conversation by c

1. Tap the group message you want to convert to a private channel.

.. image:: ../images/mobile-select-a-group-message.jpg
:alt: Select a group that you want to convert.
:scale: 30
.. image:: ../images/mobile-select-a-group-message.jpg
:alt: Select a group that you want to convert.
:scale: 30

2. Tap the **More** |more-icon-vertical| icon located in the top right corner of the app.

.. image:: ../images/mobile-select-more-options-for-a-group.jpg
:alt: Tap on More options to access available options for the group.
:scale: 30
.. image:: ../images/mobile-select-more-options-for-a-group.jpg
:alt: Tap on More options to access available options for the group.
:scale: 30

3. Tap **View info**.

.. image:: ../images/mobile-select-view-info-for-a-group.jpg
:alt: Tap on View info to see the basic group info.
:scale: 30
.. image:: ../images/mobile-select-view-info-for-a-group.jpg
:alt: Tap on View info to see the basic group info.
:scale: 30

4. Tap **Convert to a Private Channel**.

.. image:: ../images/mobile-convert-group-to-private-channel.jpg
:alt: Tap on Convert to a Private Channel to convert the group.
:scale: 30
.. image:: ../images/mobile-convert-group-to-private-channel.jpg
:alt: Tap on Convert to a Private Channel to convert the group.
:scale: 30

5. Enter the private channel name.

.. image:: ../images/mobile-provide-private-channel-name-for-the-group.jpg
:alt: Type a name for the Private channel.
:scale: 30
.. image:: ../images/mobile-provide-private-channel-name-for-the-group.jpg
:alt: Type a name for the Private channel.
:scale: 30

6. Tap **Convert to Private Channel** to confirm.
6. Tap **Convert to Private Channel** to confirm.

.. note::

- Any member of an existing group message, except :doc:`guests </onboard/guest-accounts>`, can convert that group message to a private channel.
- Conversation history will be visible to all channel members.
- All group message participants must share at least one team membership.
70 changes: 34 additions & 36 deletions source/collaborate/favorite-channels.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,71 +4,69 @@ Mark channels as favorites
.. include:: ../_static/badges/allplans-cloud-selfhosted.rst
:start-after: :nosearch:

You can mark public and private channels, as well as direct and group messages as favorites so they're easy to access later. Favorite channels display in the **Favorites** category in the channel sidebar.

.. image:: ../images/favorites-list-sidebar.png
:alt: Favorite channels display in the channel sidebar.

To mark a channel as a **Favorite**:
You can mark channels as favorites so they're easy to access later.

.. tab:: Web/Desktop

1. Open a channel.
2. Select on the star icon next to the channel name.

At the top of the page, select the |favorite-icon| icon next to the channel name.
At the top of the page, select the |favorite-icon| icon next to the channel name. Select the |favorite-icon| icon again to remove that channel from your list of favorites.

.. image:: ../images/favorite-channel-desktop.png
:alt: Mark a channel as a favorite.

To remove a channel from your **Favorites** list, select the |favorite-icon| icon again.
Favorite channels display in the **Favorites** category at the top of your channel sidebar.

.. image:: ../images/favorites-list-sidebar.png
:alt: Favorite channels display in the channel sidebar.

.. tip::

- Alternatively to mark channels as favorites, select the channel name, select the **View Info** |channel-info| icon, then select **Favorite** in the right pane. Select **Favorited** to remove the channel from your list of favorites.
Alternatively, select the channel name, select the **View Info** |channel-info| icon, then select **Favorite** in the right pane. Select **Favorited** to remove the channel from your list of favorites.

.. tab:: Mobile

1. Tap the channel you want to mark as a favorite.

.. image:: ../images/mobile-select-a-channel.jpg
:alt: Select a channel that you want to mark as favorite.
:scale: 30
.. image:: ../images/mobile-select-a-channel.jpg
:alt: Select a channel that you want to mark as favorite.
:scale: 30

2. Tap the |more-icon-vertical| icon located in the top right corner of the app.

.. image:: ../images/mobile-select-more-options-for-a-channel.jpg
:alt: Tap on More options to access available options for the channel.
:scale: 30
.. image:: ../images/mobile-select-more-options-for-a-channel.jpg
:alt: Tap on More options to access available options for the channel.
:scale: 30

3. Tap **Favorite**.

.. image:: ../images/mobile-select-view-info-for-a-channel.jpg
:alt: Tap on Favorite to mark the channel as one of the favorites.
:scale: 30
.. image:: ../images/mobile-select-view-info-for-a-channel.jpg
:alt: Tap on Favorite to mark the channel as one of the favorites.
:scale: 30

To remove a channel from the **Favorites** list, tap the **Favorited** option.

.. tip::
.. image:: ../images/mobile-unfavorite-a-channel.jpg
:alt: Tap on Favorited to unfavorite the channel.
:scale: 30

Alternatively, you can mark a favorite channel as follows:
.. image:: ../images/mobile-unfavorite-a-channel-from-within-the-channel.jpg
:alt: Tap on Favorited to unfavorite the channel.
:scale: 30

1. In a channel, tap the channel name at the top of the screen.
.. tip::

.. image:: ../images/mobile-select-more-options-for-a-channel.jpg
:alt: Tap on the channel name to view available options for the channel.
:scale: 30
Alternatively, you can mark a favorite channel as follows:

2. Tap on **Favorite**
1. In a channel, tap the channel name at the top of the screen.

.. image:: ../images/mobile-favorite-a-channel-within-channel.jpg
:alt: Tap on Favorite to mark the channel as one of the favorites.
:scale: 30

To remove a channel from the **Favorites** list, tap the **Favorited** option.
.. image:: ../images/mobile-select-more-options-for-a-channel.jpg
:alt: Tap on the channel name to view available options for the channel.
:scale: 30

.. image:: ../images/mobile-unfavorite-a-channel.jpg
:alt: Tap on Favorited to unfavorite the channel.
:scale: 30
2. Tap on **Favorite**

.. image:: ../images/mobile-unfavorite-a-channel-from-within-the-channel.jpg
:alt: Tap on Favorited to unfavorite the channel.
:scale: 30
.. image:: ../images/mobile-favorite-a-channel-within-channel.jpg
:alt: Tap on Favorite to mark the channel as one of the favorites.
:scale: 30
13 changes: 3 additions & 10 deletions source/collaborate/forward-messages.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,24 +6,17 @@ Forward messages

From Mattermost v7.2, using a web browser or the desktop app, you can forward messages in public channels to other public channels. From Mattermost v7.5, you can also forward messages from bots and webhooks.

.. note::

Private channels, direct messages, and group messages intended for specific people can't be forwarded.

To forward a message:

1. Select the **More** |more-icon| icon next to a message, then select **Forward**.

.. image:: ../images/forward-message.png
:alt: You can forward messages to others using the More option.

2. Specify where you want to forward the message, and include an optional comment.

Forwarding a message also generates a preview of the message.
2. Specify where you want to forward the message, and include an optional comment. Forwarding a message also generates a preview of the message.

.. image:: ../images/permalink-previews.png
:alt: Mattermost generates previews of links shared in Channels.

.. note::

Previews respect channel membership permissions, so they’re only visible to users who have access to the original message. If the link is to a message in a public channel, any member of the team can see the message preview. If the link is to a message in a private channel or direct message, only members in that channel can see the message preview.
- Private channels, direct messages, and group messages intended for specific people can't be forwarded.
- Previews respect channel membership permissions, so they’re only visible to users who have access to the original message. If the link is to a message in a public channel, any member of the team can see the message preview. If the link is to a message in a private channel or direct message, only members in that channel can see the message preview.
15 changes: 8 additions & 7 deletions source/collaborate/navigate-between-channels.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,19 @@ Navigate channels
.. include:: ../_static/badges/allplans-cloud-selfhosted.rst
:start-after: :nosearch:

Navigate between channels
--------------------------
Using Mattermost in a web browser or the desktop app, you can navigate between channels by selecting the **Find channel** option in the channel sidebar, or by pressing :kbd:`Ctrl` :kbd:`K` on Windows or Linux, or :kbd:`⌘` :kbd:`K` on Mac.

Using Mattermost in a web browser or the desktop app, you can navigate between channels by selecting the **Find channel** option in the channel sidebar, or by pressing :kbd:`Ctrl` :kbd:`K` on Windows or Linux, or :kbd:`⌘` :kbd:`K` on Mac. The Find channels screen also displays :doc:`member availability </preferences/set-your-status-availability>` at a glance.
.. image:: ../images/switch-channels.png
:alt: Navigate between channels and review member availability.

.. image:: ../images/switch-channels.png
:alt: Navigate between channels and review member availability.
.. tip::

Use the Find channels screen to review channel :doc:`member availability </preferences/set-your-status-availability>` at a glance.

Return to recently viewed channels
-----------------------------------

Using a web browser or the desktop app, use the **History** arrows at the top of the sidebar to move back and forth through your channel history.

- Select the left arrow to go back one page.
- Select the right arrow to go forward one page.
- Select the **left arrow** to go back one page.
- Select the **right arrow** to go forward one page.