Adding tracking to "Learn more" link in Tone Check card/hint
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	ppelberg
	Jun 12 2025, 5:17 PM

Description

This task involves the work of adding the instrumentation necessary to log the edit sessions within which people click/tap the Learn more link T390248 implements.

Story

As a member of the Editing Team , I'd value knowing when people who see a Tone Check while editing tap the Learn more link that is present within the Check card/hint so that I can learn things like: a) the extent to which people seek out additional context/instruction beyond what the current UX offers and b) how engaging with the Learn more link relates to the likelihood that someone will go on to publish a constructive new content edit.

Requirements

log feature: editCheck-tone, action: click-learn-more when someone clicks on the Learn more link in the Tone Check card/hint.

QA

Details

Related Changes in Gerrit:

	Subject	Repo	Branch	Lines +/-
	Tone check	mediawiki/extensions/VisualEditor	master	+549 -155

Customize query in gerrit

Related Objects
Search...

Status	Assigned	Task
Open	None	T265163 Create a system to encode best practices into editing experiences
Open	None	T365300 Introduce Edit Checks that encourage behavior aligned with Manual of Style consensus
Open	None	T365301 Tone Check: Prompt people to revise promotional language
Open	None	T416406 [MILESTONE] Offer Tone Check as default-on feature (all wikis)
Open	Esanders	T413026 [MILESTONE] Offer Tone Check as default-on feature at partner wikis
Open	ppelberg	T392954 [FY25-26] WE 1.1: Increase constructive edits
Resolved	MNeisler	T387918 [MILESTONE] Run an A/B test to evaluate impact of Tone Check
Resolved	MNeisler	T396786 Adding tracking to "Learn more" link in Tone Check card/hint

Event Timeline

ppelberg created this task.Jun 12 2025, 5:17 PM

Change #1149663 had a related patch set uploaded (by DLynch; author: Divec):

[mediawiki/extensions/VisualEditor@master] WIP: Tone check

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

gerritbot added a project: Patch-For-Review.Jun 13 2025, 8:06 PM

ppelberg updated the task description. (Show Details)Jun 14 2025, 2:52 AM

The patch will now log feature: editCheck-tone, action: click-learn-more when someone clicks on the learn more link in the tone check.

DLynch moved this task from Inbox to Code Review on the Editing-team (Kanban Board) board.Jun 14 2025, 3:12 AM

In T396786#10914945, @DLynch wrote:

The patch will now log feature: editCheck-tone, action: click-learn-more when someone clicks on the learn more link in the tone check.

Excellent and @DLynch – would it be accurate for me to think we'll be able to relate those clicks to the specific edit session they happened within

cc @MNeisler for awareness and review.

ppelberg updated the task description. (Show Details)Jun 14 2025, 3:21 AM

Yes, same as any other logging to VisualEditorFeatureUse.

Change #1149663 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] Tone check

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

Maintenance_bot removed a project: Patch-For-Review.Jun 16 2025, 5:30 PM

ReleaseTaggerBot added a project: MW-1.45-notes (1.45.0-wmf.6; 2025-06-17).Jun 16 2025, 6:00 PM

DLynch moved this task from Code Review to QA on the Editing-team (Kanban Board) board.Jun 30 2025, 5:08 PM

DLynch added a project: Editing QA.

ppelberg moved this task from Inbox to High Priority on the Editing QA board.Jun 30 2025, 5:35 PM

Error:

TypeError: Invalid counter value for mediawiki_editcheck_preSaveChecks_total
    at eval (statsd.js:176:18)
    at Object.handler (mediawiki.base.js:416:5)
    at fire (jquery.js:3223:31)
    at Object.fireWith (jquery.js:3353:7)
    at Object.fire (jquery.js:3361:10)
    at mw.track (mediawiki.base.js:386:17)
    at eval (load.php?lang=en&modules=ext.visualEditor.editCheck&skin=vector-2022&version=1c867:12:703)
    at eval (oojs-ui-windows.js:756:33)
    at OO.ui.Process.execute (oojs-ui-windows.js:792:39)
    at ve.init.mw.ArticleTarget.showSaveDialog (ve.init.mw.ArticleTarget.js:1991:22)

ppelberg reassigned this task from DLynch to EAkinloose.Jul 1 2025, 5:37 PM

Logs as expected:

{
    "wiki": "enwiki",
    ...
    "feature": "editCheck-tone",
    "action": "click-learn-more",
    "editor_interface": "visualeditor"
}

EAkinloose moved this task from QA to Ready for Sign Off on the Editing-team (Kanban Board) board.Jul 1 2025, 5:45 PM

Error is actually T395444.

MNeisler moved this task from Triage to Tracking on the Product-Analytics board.Jul 2 2025, 2:58 PM

ppelberg reassigned this task from EAkinloose to MNeisler.Jul 9 2025, 8:27 PM

ppelberg moved this task from Ready for Sign Off to Blocked / Needs More Work on the Editing-team (Kanban Board) board.

I've verified this event appears to be recorded correctly within visualeditorfeatureuse as well based on a few test events logged earlier in the week.

I've also added it to the VEFU dictionary

MNeisler moved this task from Next 2 weeks to Needs Review on the Product-Analytics (Kanban) board.Jul 10 2025, 5:55 PM

ppelberg mentioned this in T394464: [SPIKE] Work out what session metrics for read activity are available for use within Tone Check.Jul 11 2025, 11:58 PM

ppelberg closed this task as Resolved.Jul 12 2025, 12:04 AM

VPuffetMichel added a project: OKR-Work.Dec 8 2025, 10:44 PM

Adding tracking to "Learn more" link in Tone Check card/hintClosed, ResolvedPublicActions