Update DiscussionTools help documentation
Closed, ResolvedPublic
Actions

Description

This task involves the work with updating the DiscussionTools's documentation to ensure it contains the information people seeking to learn about the Reply Tool, New Discussion Tool, and Topic Subscriptions will expect to see.

Requirements

For each the DiscussionTools available in production (Reply Tool, New Discussion Tool, and soon, Topic Subscriptions), people reading mw:Help:DiscussionTools page should be able to easily know:

What the tool looks like
How to experience the functionality the tool offers
The features the tool offers
How to disable the feature
Where they can go to independently troubleshoot issues they might be having
Where they can go to seek the help of another person/people to troubleshoot issues they might be having

Tools

Tool	Help page updated
Reply Tool	✅
New Discussion Tool	✅
Topic subscriptions	✅

Done

The Help:DiscussionTools page is updated with the information needed to satisfy the === Requirements listed above
- See: https://w.wiki/3fxx.
A "✅" is added to the ===Tools table once information about said tool has been added to the Help:DiscussionTools page

Related Objects
Search...

Status	Subtype	Assigned	Task
Open		None	T233446 [Epic] New Discussion Tool
Open		None	T276497 Scale DiscussionTools to all projects
Open		None	T251207 [Epic] Scale DiscussionTools to all Wikipedias
Open		None	T262331 Make Reply Tool available as opt-out preference at all Wikipedias
Open		None	T275256 Make New Discussion Tool available as opt-out feature at all wikis
Resolved		LZaman	T271964 [Release ticket] Make New Discussion Tool available as opt-out feature at partner wikis
			Restricted Task
Resolved		ppelberg	T275257 Offer New Discussion Tool as Beta Feature at all Wikipedias
Resolved		Ryasmeen	T275813 Post-deployment QA (New Discussion Tool)
Resolved		matmarex	T275827 Deploy config change to scale New Discussion Tool's availability as a beta feature
Resolved		Esanders	T275923 Pressing "cancel" on an empty new topic widget triggers the title validation and doesn't close the widget
Resolved		matmarex	T276967 Turn off Reply Tool A/B test
Resolved		Whatamidoing-WMF	T275828 Make volunteers aware of New Discussion Tool's availability as beta feature
Resolved		Whatamidoing-WMF	T275830 Verify integrity of New Discussion Tool edits at ar, cs and hu.wiki
Resolved		ppelberg	T273082 Offer Reply and New Discussion Tools as Beta Features at "Phase 4" Wikipedias.
Resolved		matmarex	T273146 Make the Reply and New Discussion Tools available as opt-in Beta Features at en.wiki
Resolved		Whatamidoing-WMF	T273147 Consult with volunteers at en.wiki about offering the Reply Tool as a Beta Feature
Resolved		Whatamidoing-WMF	T273233 Update en.wiki Talk pages project page
Resolved		matmarex	T276493 Make the Reply Tool and New Discussion Tools available as opt-in Beta Features at ru.wiki
Resolved		Whatamidoing-WMF	T275255 Consult with volunteers at ru.wiki about offering the Reply Tool as a Beta Feature
Resolved		matmarex	T276494 Make the Reply and New Discussion Tools available as Beta Features at de.wiki
Resolved		Whatamidoing-WMF	T275254 Consult with volunteers at de.wiki about offering the Reply Tool as a Beta Feature
Open		None	T277506 Enable New Discussion Tool as opt-out setting at office.wiki
Declined		MNeisler	T263054 New Discussion Tool: calculate workflow engagement metrics
Open		None	T277825 Run A/B test to evaluate impact of New Discussion Tool
Resolved		MNeisler	T290204 [SPIKE] Estimate New Discussion Tool A/B Test Feasibility
Open		Whatamidoing-WMF	T291306 Identify wikis for New Discussion Tool A/B test
Open		None	T291307 Implement New Discussion Tool A/B test bucketing
Open		None	T291536 [SPIKE] How can we ensure that we are able to identify and distinguish prior users of the New Discussion Tool in the AB test?
Open		None	T291308 Make config change to start New Discussion Tool A/B Test
Open		iamjessklein	T270788 Introduce a "feature peek" for the New Discussion Tool
Open		ppelberg	T288741 Talk Page Empty State: write English copy for translation
Resolved	BUG REPORT	matmarex	T291085 redlink=1 not respected in zhwiki
Open		None	T291535 Inform participating wikis of start of New Discussion Tool A/B Test
Open		None	T291873 Deploy config change to "turn off" New Discussion Tool A/B test
Open		None	T292120 [SPIKE] Determine how we can identify blocked save attempts
Open		iamjessklein	T293962 Introduce a "hint" that informs people how they can enable the legacy section=new experience
Open		None	T285117 Add support for the InputBox extension
Open		matmarex	T269310 Add support for preloaded text
Resolved		Ryasmeen	T269033 Add edit notice element to New Discussion Tool
Resolved		ppelberg	T270454 Implement edit notice logic
Resolved		Esanders	T272188 VE API: Return structured information about edit notices so they can be filtered by clients
Open		None	T272656 Solicit feedback from page maintainers about preload opt-in approach
Open		None	T270797 Create way for individual pages to opt-in to using the New Discussion Tool for preloads
Resolved		ppelberg	T274746 Create an easy way to link people to an open New Discussion Tool
Resolved		ppelberg	T282204 Handle URLs for starting new sections
Open		Whatamidoing-WMF	T287804 Create deployment plan for scaling New Discussion Tool as opt-out at all projects
Resolved		matmarex	T287901 Revise empty Title field warning message display logic
Open		ppelberg	T288319 [SPIKE] What should be shown on empty talk page when corresponding page doesn't exist either?
Open		None	T290517 [Release Ticket] Introduce New Discussion Tool as opt-out at Phase 1 wikis
Open		None	T284489 Deploy topic subscriptions as opt-out feature at all projects
Open		None	T233447 [OKR] Increase response rates
Open		None	T274833 Enable topic subscriptions as opt-out at partner wikis
Resolved		Whatamidoing-WMF	T284259 Update DiscussionTools help documentation

Event Timeline

ppelberg created this task.Jun 3 2021, 9:17 PM

ppelberg added parent tasks: T262331: Make Reply Tool available as opt-out preference at all Wikipedias, T274833: Enable topic subscriptions as opt-out at partner wikis.

ppelberg moved this task from Backlog to Community Engagement on the Editing-team (Tracking) board.

matmarex removed a subscriber: matmarex.Jun 4 2021, 2:53 PM

LZaman mentioned this in T271964: [Release ticket] Make New Discussion Tool available as opt-out feature at partner wikis.Jun 29 2021, 10:19 PM

matmarex moved this task from Backlog to Triaged on the DiscussionTools board.Jul 1 2021, 2:57 PM

Marking this ticket as Resolved considering the updates @Whatamidoing-WMF made to the page [i] satisfy the requirements listed in the task description.

i. https://www.mediawiki.org/w/index.php?title=Help:DiscussionTools&type=revision&diff=4676171&oldid=4673204&diffmode=source

ppelberg updated the task description. (Show Details)Jul 24 2021, 12:16 AM

Update DiscussionTools help documentationClosed, ResolvedPublicActions