Since this will be a significant change to the core of the messaging experience as it relates to threaded replies, onboarding is an important consideration.

Important Links

GA Phase Onboarding

When the user meets ALL the following conditions, show the pulsing dot next to the “Threads” item in the sidebar (shown below). When the dot or “Threads” item is clicked, switch to the threads view and then start the tour (beginning with the modal).

Conditions:

• The user has not seen this tour before

• The client has CRT enabled

• The user has 1 or more threads

• The user has completed or opted out of the initial on-boarding tour. Removing this condition in MM-41281: Remove check for onboarding tour finish to trigger CRT tourClosed

Open

Tour

The tour itself will compose of an intro modal and three tips.

If the user clicks “Skip” or on any “x” at any point in the tour then we should not show any more tips and we should mark the tutorial as completed so they never see it again.

Do not allow the user to click outside any of the tips to dismiss them. They must click “Next” “x” or “skip”.

Tour Step 1: New Feature Intro

This modal uses similar UI to the in-product notices but shows dots to indicate the progress through the tour.

Open

Tour Step 2: Global Threads View Intro

This tip appears as soon as the user clicks “Take the tour” in the modal above. In order to show this tip we need to force open this view (ie switch the user to “Threads” from whatever channel they were viewing before)

For each of the following tour points, an animated pulsing dot displays under the the tour point arrow to draw attention to the are of focus.

Tour Step 3: Global Threads List

This tip appears as soon as the user clicks “Next” on the step above.

Tour Step 4: Global Threads List - Unreads Filter

This tip appears as soon as the user clicks “Next” on the step above.

Once the user clicks “Finish tour” then we should dismiss the tips and mark the tour as complete so the user never sees it again.

RHS Threads Tour

Separate from the tour above, when the collapsed threads feature is enabled, the first time a thread is opened up in the RHS, this tour point displays. A user should only see this once, so we should store (separately from the tour) when they’ve seen this tip so it never appears again.