This task represents the work involved with increasing peoples' awareness of things others say in conversations they are interested in.
//More details below.//
=== Objective and theory of change
**Objective**
This work is intended to increase the likelihood Junior and Senior Contributors receive timely and relevant responses to the things they say.
**Theory of change**
We think that:
- //If// people are able to be more specific in deciding the new comments they are and are not notified about...
- //...then// they will be able to more easily and quickly identify comments requiring a response...
- //...and// be more likely to respond to those comments in a timely manner.
=== Background
**Challenges**
- On pages that have many active threads[i], people have a difficult time staying up-to-date about the specific conversations they are interested in.
-- //"...pertinent changes to sections that interest me get superseded by subsequent changes to other sections."// | [Source: meta.wiki](https://meta.wikimedia.org/wiki/Community_Wishlist_Survey_2015/Watchlists#Section_watchlists)
- On pages that have a few active threads [i], people can miss out on comments posted in other, less active, sections.
-- //" Sometimes the movement of the terrace is very large, and times when only one or two topics account for almost all editions on the terrace. When this happens editions in other topics may go unnoticed among others, then we don't even see that there are new comments, sometimes we don't even see that there is a new topic"// | [Source: pt.wiki](https://pt.wikipedia.org/wiki/Wikip%C3%A9dia:Esplanada/geral/English_Wikipedia_and_Portuguese_Wikipedia_discussion_forums_(1set2012))
**Implications**
- People risk missing important information about their wiki work
- People risk not responding to others who would value their input
The risks above are especially important for they threaten a core promise people depend on talk pages to fulfill: to facilitate interactions with other people. //Said another way: if people understand talk pages as places to talk with other people and those "other people" don't respond in a timely manner, the people seeking contact with others will lose faith in and stop using talk pages.//
=== Rquirements
**Meta**
- Platforms: **mobile** and **desktop**
- Editing interfaces: should be able to be notified about "qualifying comments" //regardless// of the editing interface used to publish them. //Said another way: whether someone posted a comment using the Reply Tool or full-page wikitext editing should *not* affect the notification said comment triggers.//
**Being made aware functionality exists**
- Upon landing on a talk page that contains at least one "qualifying section," people should know it is possible to subscribe to receive notifications about new comments posted to them and how to go about doing this.
**Initiating subscriptions**
- People should be able to subscribe to be notified about "qualifying comments" posted in any "qualifying sections" on the page.
- The first time people subscribe to a "qualifying section," they should understand the following:
-- What the action they just took means for them. //Read: when other people post new comments to this topic, the person subscribing will be notified.//
-- They have the ability to control how they receive these notifications and how to exercise this control. //Read: visit `Special:Preferences#mw-prefsection-echo`//
- Upon subscribing to receive notifications about new comments about a topic, people should be able to quickly scan the page and identify the topics they are and are not currently subscribed to receive notifications about.
**Qualifying sections**
- People should be able to elect to be notified about qualifying comments in sections that meet //any// of the following conditions:
-- The section exists on a page in a talk namespace
-- The section exists on a page where `__NEWSECTIONLINK__` is present (T245890)
- The section starts with an `==H2` heading
**Qualifying comments**
- Comments that meet the conditions below should cause people who have subscribed to that topic to receive notifications in the way(s) they've elected to in `Special:Preferences#mw-prefsection-echo`:
-- The comment was posted at any point //after// people subscribed to the topic
-- The comment was published by someone other than the person who subscribed to the topic.
**Notification delivery/receipt**
- Notifications about new comments in sections people are subscribed to should appear in `Notices`.
- By default, notifications about new comments in sections people are subscribed to should be delivered through the same channels (e.g. Web/Apps/Email) people have elected to receive notifications for `Talk page message`.
- People should be able to elect to receive topic subscription notifications on all of the platforms they may be contributing (web, iOS and Android).
**Notification contents**
- The topic subscription notifications people receive should equip them with all of the information/context they will need to know what – if any – action they need to take as a result of having received the notification. //Example components listed below...//
-- What the notification is.
--- //E.g.: a new comment in a topic you are subscribed to.//
-- Where the notification comes from.
--- //E.g. the title of the topic the comment was added to and the title of the page on which that topic exists.//
-- Why the recipient is being notified.
--- //E.g. They are subscribed to this topic.//
-- Who wrote the comment the person is being notified about.
-- When the comment they were being notified about was written.
-- Enough of the comment-triggering-notification's content for the person receiving it to know what – if anything – they need to do in response.
**Notification actions**
- The topic subscription notifications people receive should enable them to take the following actions:
-- View the comment they are being notified about in context
-- Reply to the comment they are being notified about
-- Turn off notifications for the section the specific notification "belongs" to
-- Mark a notification as "read"
-- Learn about the author of the comment they are being notified about
**Notification management**
- People should be able to control the channel through which notifications about topics they are subscribed to are delivered. //E.g. "Web," "Email," and "Apps".//
**Subscription management**
- [LATER] People should be able to see all of the topics they are subscribed to in one location. Withi this same view, people should be able to turn on/off subscriptions to individual topics within this list.
=== Open questions
- [ ] 1. Can we ensure topic subscription notifications be delivered via the apps?
- [ ] 2. How might topic subscriptions get implemented on the apps?
- [ ] 3. What should happen to the watch this page checkbox within the Reply and New Discussion Tools?
- [ ] 4. How – if at all – does peoples' use of the Reply Tool and New Discussion Tool affect topic subscriptions?
- [ ] 5. How – if at all – should topic subscriptions consider/relate to temporary watchlisting?
- [ ] 6. What happens if a topic you are subscribed to gets renamed? T262991
- [ ] 7. What happens if a specific section you are watching gets moved? T262990
=== Done
- [ ] All `===Open questions` are addressed
- [ ] Mockups are created that fulfill the `===Requirements` above.
---
=== References
//The above is built on valuable thinking and talking that has happened in the past. Links to *some* of this research and conversations are listed below. If you can think of more, please boldly add it here and post a comment alerting us that you've done so.//
- https://meta.wikimedia.org/wiki/Community_Wishlist_Survey_2016/Categories/Watchlists#CW2016-R043
- https://meta.wikimedia.org/wiki/Community_Wishlist_Survey_2015/Watchlists#Section_watchlists
- https://en.wikipedia.org/wiki/Wikipedia:Village_pump_(proposals)/Archive_93#Support_or_oppose_a_test_Village_Pump_based_on_Portuguese_VP
- https://pt.wikipedia.org/wiki/Wikip%C3%A9dia:Esplanada/geral/English_Wikipedia_and_Portuguese_Wikipedia_discussion_forums_(1set2012)
---
i. E.g.: AfD (en.wiki), Tearoom (en.wikitionary), Village pump (ru.wiki), user pages (e.g. User:WhatamIdoing), wp:ANI (en.wiki), wp:Reference desk (en.wiki), WP:ERRORS, Wikipedia:AN, Wikipedia:Village pump (technical), Teahouse