Create a guided tour about accessing a StructuredDiscussions Topic page the first time
Closed, DeclinedPublic
Actions

Assigned To

None

Authored By

	Trizek-WMF
	Nov 26 2018, 2:09 PM

Description

This tour is triggered when someone logged-in accesses a Topic using StructuredDiscussions (SD) the first time (not a talk page, see T210402).

Content of the tour

1

Title: This page is StructuredDiscussions topic. Let's take a tour?
Body text: This quick tour will show you how to use that topic page the best
Buttons:

"Skip" - closes the tour
"Discover some features" (main) - goes to #2

Location: centered modal

2

Title: You are on a topic page, where a conversation happen
Body text: You can read any comments and reply to them, following the topic of that page
Buttons: "How to reply?" - goes to #3
Location: Topic title.

3

Title: Reply to the whole conversation
Body text: You can reply to the whole conversation by clicking on the "Reply to" field.
Buttons: "How to reply to a specific comment?" - goes to #4
Location: The "Reply to" field at the bottom of the conversation. The tour must show that field (autoscroll).

4

Title: You can reply to any message
Body text: If you click on "reply" here, you will post a direct reply to this message. This message will be indented.
Buttons: "How to watch topics?" - goes to #5
Location: The first comment "reply" button.

5

Title: You can monitor that conversation
Body text: Like any other page, you can monitor the activity here. Click on the star, and you will get notifications when someone replies.
Buttons: "Next", goes to #6

6

Title: Now you know the most important points
Body text: Those commands applies to any topic taken separately, or gathered on a talk page.

Closing button (main)
"Open help page" - goes to https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Structured_Discussions

Location: The link path under the page title

Create a tour

See: https://www.mediawiki.org/wiki/Extension:GuidedTour#Technical_documentation

i18n

Each step have to be translatable through translatewiki.net.

CGI 2018

Imported as https://codein.withgoogle.com/dashboard/tasks/5623448349966336/

Details

	Subject	Repo	Branch	Lines +/-
	Flow: Add Topic tour for GuidedTour extension	mediawiki/extensions/Flow	master	+212 -13

Customize query in gerrit

Related Objects
Search...

		Status	Subtype	Assigned	Task
		Resolved		Trizek-WMF	T112757 Create a guided tour about StructuredDiscussions
		Declined		None	T210403 Create a guided tour about accessing a StructuredDiscussions Topic page the first time

Event Timeline

Trizek-WMF triaged this task as Low priority.Nov 26 2018, 2:09 PM

Trizek-WMF created this task.

Trizek-WMF mentioned this in T210402: Create a guided tour about Talk pages using StructuredDiscussions.

Trizek-WMF updated the task description. (Show Details)

Trizek-WMF moved this task from Inbox to External on the Growth-Team board.

Trizek-WMF renamed this task from Create a guided tour about Topic pages on StructuredDiscussions to Create a guided tour about accessing a StructuredDiscussions Topic page the first time.Nov 26 2018, 6:22 PM

Trizek-WMF updated the task description. (Show Details)Nov 28 2018, 2:58 PM

@Aklapper, I've imported that task. Can you add @SBisson as a mentor? Thanks!

takidelfin claimed this task.Dec 4 2018, 7:46 PM

takidelfin subscribed.

Trizek-WMF moved this task from External to FY 2019-20 on the Growth-Team board.Dec 6 2018, 9:55 AM

Change 477989 had a related patch set uploaded (by Takidelfin; owner: Takidelfin):
[mediawiki/extensions/Flow@master] Flow: Add Topic tour for GuidedTour extension

https://gerrit.wikimedia.org/r/477989

gerritbot added a project: Patch-For-Review.Dec 6 2018, 11:32 AM

SBisson moved this task from FY 2019-20 to External on the Growth-Team board.Dec 6 2018, 2:47 PM

Trizek-WMF updated the task description. (Show Details)Dec 7 2018, 3:09 PM

@SBisson Looks like I need to add step 5 for IP users too, right? :/

Also, there are CSS related bugs

screenshot_20181208_021411.png (87×347 px, 4 KB)

Done!

if ( mw.config.get( 'wgUserName' ) && !mw.user.options.get( 'flow-guidedtour-topic-seen' ) ) {
    [...]
} else if ( !mw.config.get( 'wgUserName' ) && !$.cookie( 'flow-guidedtour-topic-seen' ) ) {
    [...]
}

Patch is ready for a review

@takidelfin, have you managed to display to tour to IPs? The target for the tour is experienced users used to wikitext talk pages, aka already logged-in users. IPs are a plus.

@Trizek-WMF yup, using cookies. But @SBisson says that there can be problems when the user does not accept cookies.

Trizek-WMF updated the task description. (Show Details)Dec 11 2018, 1:52 PM

Cookies can work but they are not reliable. The consequence if anything goes wrong is that the user would see the tour every single time they go to a topic page.

Guided Tour could have the infrastructure to keep track of IP users but it doesn't. I recommend we exclude anons for this task.

In T210403#4813815, @SBisson wrote:

Guided Tour could have the infrastructure to keep track of IP users but it doesn't. I recommend we exclude anons for this task.

Let's do this.

Trizek-WMF updated the task description. (Show Details)Dec 11 2018, 2:05 PM

Should I comment out cookies thing?

In T210403#4813827, @takidelfin wrote:

Should I comment out cookies thing?

You can remove it from the patch completely.

@SBisson I think it is ready for review

In T210403#4826659, @takidelfin wrote:

@SBisson I think it is ready for review

Sorry for the delay @takidelfin. Stephane will be back from vacation next week. :)

What is the status of that task now?

In T210403#4878260, @Trizek-WMF wrote:

What is the status of that task now?

The patch is ready to go. I didn't merge it because I am worried that experienced users will all see the tour after using the topic page for years and be annoyed. What do you think?

How can we know if someone has already visited a topic page? That would solve our problem (we exclude those users), but I'm pretty sure we can't.

Since there is a skip button on step 1, that's okay. They will not be forced the tour entirely. Curious ones will be happy to discover the interface.

We can give a try and have a limited deployment on mediawiki.org for now.

In T210403#4881028, @Trizek-WMF wrote:

How can we know if someone has already visited a topic page? That would solve our problem (we exclude those users), but I'm pretty sure we can't.

We can't know for sure. We could assume that a user with some amount of Flow contribution is familiar with the topic page (which is almost identical to the board page but with only one topic) but it's getting complicated. I don't know if it's worth it.

Since there is a skip button on step 1, that's okay. They will not be forced the tour entirely. Curious ones will be happy to discover the interface.

We can give a try and have a limited deployment on mediawiki.org for now.

We can do that but I'll have to rework the patch to make the tour configurable per wiki.

In T210403#4881231, @SBisson wrote:

In T210403#4881028, @Trizek-WMF wrote:

How can we know if someone has already visited a topic page? That would solve our problem (we exclude those users), but I'm pretty sure we can't.

We can't know for sure. We could assume that a user with some amount of Flow contribution is familiar with the topic page (which is almost identical to the board page but with only one topic) but it's getting complicated. I don't know if it's worth it.

I'm not convinced. Let's not try that for now.

Since there is a skip button on step 1, that's okay. They will not be forced the tour entirely. Curious ones will be happy to discover the interface.

We can give a try and have a limited deployment on mediawiki.org for now.

We can do that but I'll have to rework the patch to make the tour configurable per wiki.

Do you think @takidelfin can handle that?

Aklapper edited projects, added Patch-Needs-Improvement; removed Patch-For-Review.Feb 13 2021, 6:58 PM

MBinder_WMF added a project: Growth-Team-Filtering.Apr 15 2021, 6:52 PM

Removing task assignee due to inactivity, as this open task has been assigned for more than two years (see emails sent to assignee on May26 and Jun17, and T270544). Please assign this task to yourself again if you still realistically [plan to] work on this task - it would be very welcome!

(See https://www.mediawiki.org/wiki/Bug_management/Assignee_cleanup for tips how to best manage your individual work in Phabricator.)

StructuredDiscussions is dead, this should not be worked on.

Change #477989 abandoned by Bartosz Dziewoński:

[mediawiki/extensions/Flow@master] Flow: Add Topic tour for GuidedTour extension

Reason:

Flow will not be deployed to any new projects, so adding new tours does not make sense any more. Apologies for wasting your work.