@iamjessklein can you please fill in the task description's ===Done section?

@ppelberg - I added "Done" in the "Description" for your review.

For context, this is what it looks like to unsubscribe from that location on Flow:

In the Notification Dropdown, you click on the overflow menu:

and then when you click "Stop watching this topic" dropdown , the overflow (...) menu disappears and you receive a toast pop up:

The link in the Toast message takes you to the top of the page that you are Subscribing/Unsubscribing to.

In T279150#6972387, @iamjessklein wrote:

@ppelberg - I added "Done" in the "Description" for your review.

Thank you, @iamjessklein. I've edited the ===Done section slightly. Provided the edits I made sound good to you, I think the task description is in a good place.

Considering that we currently don't have an opinion on T279312, and we don't have a dashboard of some sort for notifications, and aren't planning on bringing topic subscription into the Watchlist, I think we should default to using the same visual language as Flow (star and overflow menu) but change the copy to say "Unsubscribe from this topic." (Change all the verbs)

So it will be:

1. overflow menu
2. unsubscribe
3. toast (no link) that plainly states "You've been unsubscribed from this topic" and disappears.

Considering this proposal, I don't believe that we will need to what's described in "Done" in order to communicate this to @Esanders :

Create mockups for each step people will take for unsubscribing to specific topics from within the "notification card" in Echo, on mobile and desktop

Update: After a handful of conversations, which resulted in the following tickets:

• T279312
• T279498

@ppelberg @Esanders and I came to the follow near term agreements:

1. Watchlists and Echo notifications will be treated separately
2. We will not be making changes to Echo

which limits us in what we can do with the design, in that we need something that includes the ellipsis (overflow) icon and a dropdown. Given those constraints I've come up with the design (this is a wireframe) below. Note that I have included a design with a "Report Abuse"as an item in the dropdown menu for the purpose of future conversation as I think it's bizarre to have a dropdown with one item in it, I think that we should consider the potential of making this overflow more robust.

and... here's what *I believe* that will look like in mobile (I followed the current mobile echo pattern):

in both scenarios, the contributor will click it and unsubscribe and then get the toast message.

@ppelberg @Esanders please +1 (or comment otherwise) after reading this so we can move this into implementation.

@iamjessklein: +1; everything you described in T279150#6981608 sounds good to me.

Meta
I've added a research question [i] to T279164's task description.

Reason: I wonder whether – what I perceive to be – the vagueness of the Unsubscribe copy will cause Junior Contributors to be uncertain about what will happen if they click the Unsubscribe affordance from within the Echo dropdown.

i. "Do Junior Contributors instinctively know how to stop receiving notifications from a particular conversation from within the Echo dropdown?"

That sounds great @ppelberg.

Change 680331 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/DiscussionTools@master] WIP unsub button

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

In T279150#6981608, @iamjessklein wrote:

Turns out we can't have "Unsubscribe" without an icon - every action in the echo tray needs to have an icon. I will provisionally use the star outline icon.

Without the context of other icons (play, pause etc.), the stop icon doesn’t seem obvious for me. What about a ⛔ “no entry” sign? With less precedence I can imagine an X sign as well, or maybe an 🛑 octagonal STOP street sign.

Agree the stop sign doesn't read out of context.

Would be easier to begin with if we can use something existing: https://doc.wikimedia.org/oojs-ui/master/demos/?page=icons&theme=wikimediaui&direction=ltr&platform=desktop

Long term we may need a subscribe/unsubscribe pair, e.g. for mobile

@Esanders - can you clarify what needing an icon means here? Does it mean that if we had an overflow menu with a dropdown, the dropdown list item would need an icon? Or does it mean in this scenario that the overflow icon is "the icon"?

the dropdown list item would need an icon

Yes - wherever the button goes (in the main set, or the overflow list) it needs to have an icon.

Test wiki created on Patch Demo by JKlein (WMF) using patch(es) linked to this task:

https://patchdemo.wmflabs.org/wikis/6c5e33c9b8/w/

@Esanders - can we do just the overflow with the text or do we need it to look more like this:

In T279150#7043473, @Esanders wrote:

Long term we may need a subscribe/unsubscribe pair, e.g. for mobile

As discussed during today's standup, we are going to do the following..

Next steps

• First, for the purposes of the upcoming usability test (T281438), implement what @iamjessklein is showing in T279150#7046062
• Then, decide whether subscribing/unsubscribing from within Echo is required to offer manual topic subscriptions as a Beta Feature at partner wikis (T274188)
• If we decide subscribing/unsubscribing from within Echo is required, we'll prioritize work on designing and implementing dedicated subscribe/unsubscribe iconography (T281541)
• If we decide subscribing/unsubscribing from within Echo is NOT required, we'll hide what was implemented in this task until we prioritize work on T281541

@matmarex the way that you've implemented it works as expected.

If we decide subscribing/unsubscribing from within Echo is required, we'll prioritize work on designing and implementing dedicated subscribe/unsubscribe iconography

As this is a fairly low visibility feature, I don't think the iconography has to be finalised for this to go out. This is not like deciding which icon to use on the talk page itself, so we can easily change it later.

In T279150#7048746, @Esanders wrote:

If we decide subscribing/unsubscribing from within Echo is required, we'll prioritize work on designing and implementing dedicated subscribe/unsubscribe iconography

As this is a fairly low visibility feature, I don't think the iconography has to be finalised for this to go out. This is not like deciding which icon to use on the talk page itself, so we can easily change it later.

I agree with what Ed is proposing above: offer manual topic subscriptions as an opt-in beta feature equipped with the "unsubscribe from within Echo" functionality included.

In doing the above, we are saying:

1. We are comfortable with the "🔔" icon symbolizing the "unsubscribe" action from within Echo while the feature is available as an opt-in beta feature.
2. We are comfortable with the same "🔔" icon symbolizing: A) the "Unsubscribe" action in/on new comment notifications withi Echo and B) "Alerts" within a person's "user links"
3. We are comfortable changing the "🔔" icon when we come back to thinking about the Subscribe / Unsubscribe affordance more broadly. This thinking and work will happen in T281541.

@iamjessklein I'm copying you on this comment to ensure you've had the opportunity to comment anything that concerns you about the above.

+1

Change 680331 merged by jenkins-bot:

[mediawiki/extensions/DiscussionTools@master] Notification unsubcribe button

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

The implementation also includes the email and no-JS workflows, which were not covered in the mockups above. They look like this:

Email

Depending on the "Email format" preference in Special:Preferences → Notifications:

HTML
Plain text

No-JavaScript Special:Notifications

Unsubscribing interface

The "Unsubscribe" links in both of the above point to the following interface:

Also, while reviewing the patch, I noticed and submitted patches for a few minor issues in other code:

• https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Inbox/+/697650
• https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Echo/+/697664
• https://gerrit.wikimedia.org/r/c/mediawiki/core/+/697670

(no action needed, just bragging)

Test wiki created on Patch Demo by JKlein (WMF) using patch(es) linked to this task:

https://patchdemo.wmflabs.org/wikis/a82dc63bdd/w/

nice not so humble brag @matmarex

One thing that feels slightly off is that when I unsubscribe from the dropdown, I have to refresh the page for the contextual [unsubscribe] to change back to subscribe. Is that unavoidable?

I had a quick look, and it doesn't seem to be easy to fix that. Our interface and the notifications interface are not aware of each other, and our interface has no way to react to anything happening in the notifications interface. It is definitely possible to make that happen, but we'd need to make some changes to Echo, I'd prefer to handle this in a separate task.

Great, I filed that as T284322
Moving this over to QA now.

Test wiki on Patch demo by JKlein (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmflabs.org/wikis/a82dc63bdd/w/

Test wiki on Patch demo by JKlein (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmflabs.org/wikis/6c5e33c9b8/w/