Page MenuHomePhabricator

Research & POC: Visual Editor "Add a link" Structured Task UX when completing a task surfaced in the read view
Closed, ResolvedPublic5 Estimated Story Points

Description

User story & summary:

As a newcomer working on an "Add a link" task, I want the task to be straightforward, quick, and clearly explained, so that my editing experience feels easy and rewarding, increasing the likelihood that I'll complete the task and return to edit again.

Background:

This task is critical because the current "Add a link" logic can sometimes lead to a confusing experience, and refining the flow could help ensure that newcomers have a smooth editing experience.

When a newcomer taps on a specific link suggestion in the article view and the task opens in the Visual Editor (VE), should we navigate directly to that particular suggestion, even if it's not the first suggestion on the page?

  • Option 1: Surface only the tapped link suggestion? If so, would we need to adjust the task design to make this approach intuitive? (For example the 1/1 suggestion counter and Next button no longer add value and might be confusing).
  • Option 2: Should we highlight the tapped link suggestion first while still surfacing the other link suggestions (two or more)? If so, should we clarify this in the pop-up text to avoid giving the impression that newcomers are expected to complete more than they anticipated?

We should move forward with option 1.

Designs for option 1

(see T379854: Surfacing "add a link" from an Article: link UX )

  • Removing the counter, and replacing that text with 'Add a suggested link'
  • Removing Previous/Next arrows

add_a_link_UX.png (1×3 px, 264 KB)

Acceptance Criteria:
  • Technical research spike: investigate the feasibility and pros and cons of the two options. Write a short summary in this task detailing the work involved and estimated effort of each.
  • Complete initial proof of concept to move forward with Option 1.

Timebox: TBD

Event Timeline

KStoller-WMF triaged this task as Medium priority.
KStoller-WMF moved this task from Inbox to Up Next (estimated tasks) on the Growth-Team board.
KStoller-WMF raised the priority of this task from Medium to High.Dec 4 2024, 4:05 PM

Open question:
How do we handle the other link suggestions? Do we remove them from the task queue? Do we consider surfacing them as a "post edit" suggestion? As a mid-edit suggestion?

KStoller-WMF set the point value for this task to 3.Dec 10 2024, 5:14 PM
KStoller-WMF lowered the priority of this task from High to Medium.Dec 10 2024, 6:00 PM

Change #1113189 had a related patch set uploaded (by Sergio Gimeno; author: Sergio Gimeno):

[mediawiki/extensions/GrowthExperiments@master] [WIP] poc(AddLink): show only the clicked suggestion

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

I've uploaded a poc patch for early engineering review (cc @Michael) . The poc does not include UI tweaks like hiding the counter (1/1) and stepper dot, I'd refine the UI when we make a decision on which option we want. The takeaway is that both options are feasible and of similar complexity, Option 2 is a bit more of work because it requires re-working the initial focus to a recommendation different than the first. A rough estimate of finalizing this work is 2-3 SPs.

KStoller-WMF renamed this task from Research spike: Visual Editor "Add a link" Structured Task UX when completing a task surfaced in the read view to Research & POC: Visual Editor "Add a link" Structured Task UX when completing a task surfaced in the read view.Jan 22 2025, 8:04 PM
KStoller-WMF updated the task description. (Show Details)
KStoller-WMF changed the point value for this task from 3 to 5.

Adjusting the task title and description to reflect the decision discussed in standup. I bumped up the estimation as we've expanded the scope of this task (but feel free to adjust further if "5" doesn't seem right).

Open question:
How do we handle the other link suggestions? Do we remove them from the task queue? Do we consider surfacing them as a "post edit" suggestion? As a mid-edit suggestion?

I believe it is fine to remove them from the task queue and not show them in the post-edit dialog, the article may re-appear in the task queue after a day offering the non-rejected recommendations.

I believe it is fine to remove them from the task queue and not show them in the post-edit dialog, the article may re-appear in the task queue after a day offering the non-rejected recommendations.

That works for me.

Change #1113189 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] feat(surfacing): show only the clicked suggestion

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

Note for testers: the change entailed updates in standard Add a link workflow initiated from the homepage, so it would be nice to check that flow too. (The changes are mainly in the suggestion drawer/dialog construction).

Note for testers: the change entailed updates in standard Add a link workflow initiated from the homepage, so it would be nice to check that flow too. (The changes are mainly in the suggestion drawer/dialog construction).

Found an issue - T385542: [testwiki-wmf.15] Add link inspector elements are misaligned

Testing notes:
The current workflow for Surfacing Add link task on beta cluster

  • create a user account
  • add a user to Control group with ge.utils.setUserVariant('control')
  • find an article with link-recommendation (on Special:Homepage).
  • in the Search box enter the title of the article and go the page
  • Surfaced Add link should be highlighted - only one link per article
  • after one edit (e.g. one link is added), Surfaced Add link won't be shown to that user