Help Wanted: Document deep links, their value, and how to create them

[cwarnermm]

trafficstars

Context

The Mattermost Product Documentation doesn't provide guidance on what deep links are, details about the value of deep links, or details on how to configure a deep link in Mattermost.

What's a Mattermost Deep Link?

A Mattermost deep link is a URL that takes users directly to a specific location within a Mattermost instance, such as a particular channel, message, user, or other in-app content. Deep linking makes navigation more efficient and enhances the user experience by allowing users to quickly view or interact with relevant content directly.

Benefits of Configuring Mattermost Deep Links

• Direct Access: Users can directly access specific conversations, messages, or other content without needing to navigate through the app.
• Improved Workflow: Deep links can streamline workflows by providing quick access to relevant content, facilitating easier collaboration and faster decision-making.
• Easy Sharing: Deep links allow users to share specific content within Mattermost with others, improving communication and collaboration.
• Efficiency: Reduces the amount of time spent searching for content, making everyday tasks more efficient.

Examples of Mattermost Deep Links

• Opening a specific channel: mattermost:///channels/
• Opening a specific user profile: mattermost:///users/
• Opening a specific post in a channel: mattermost:///pl/

How to Use Mattermost Deep Links

• For Channels: Use the format mattermost:///channels/ to link directly to a channel. For example: mattermost://example.mattermost.com/channels/town-square
• For Posts: Use the format mattermost:///pl/ to link directly to a specific post.

Create a Deep Link

1. Navigate to the content you want to link to in Mattermost.
2. Right-click (or use the context menu) and look for an option to copy the link. This usually provides the correctly formatted deep link.
3. Share or use this link as needed within your workflows or communications.

Documentation Request

Add documentation on what deep links are, where/how/when they're useful, and how to create them.

QA Validation Criteria

In a generated docs preview:

• Visiting the docs page directly returns details about deep links in a new subsection.