Page MenuHomePhabricator

Usability: Difficulty finding the needed function because function details don’t match participants’ mental model
Closed, ResolvedPublic

Description

Difficulty finding the needed function because function details don’t match participants’ mental model

Even when the function they were looking for existed, participants didn’t immediately find them because the search term they used didn’t match the function description and title and the description/title didn’t match what they had in mind. Also the function didn’t show up in the results if you didn’t search for the exact title e.g. Searching for ‘Age’ shows the age function but ‘age range’ doesn’t.

Recommendation
Goal: Improve the search algorithm, and function titles and descriptions.

Ideas:

  • Make the search matching individual words within a query, not just exact phrases
  • Review and improve function names, descriptions, and tags to better align with common user terminology and search queries.
  • In the No results page, ask users to rephrase their search query

Design
Additional copy advises users to try a different query if their first query yields no result.

image.png (1×750 px, 115 KB)

Event Timeline

gonyeahialam raised the priority of this task from Medium to High.Jul 9 2025, 1:55 PM
gonyeahialam changed the task status from Open to In Progress.Jul 18 2025, 5:58 PM

Since T400268 Spike: Explore MW's SearchEngine class structure, and whether switching to it from our existing SQL LIKE pattern for label search will help can't be done within the time frame. I propose we implem,ent this solution this week:

V1V2
image.png (1×750 px, 115 KB)
image.png (1×750 px, 156 KB)

This design modifies the empty state when there are no results.
V1: Users are advised to try a different query if their first query yields no result.
V2: In addition to the above, additional CTAs are shown to the user which will be helpful if the function they are looking for doesn't exist.

We can focus on V1 for now cc @gengh @DSmit-WMF

Change #1184531 had a related patch set uploaded (by Genoveva Galarza; author: Genoveva Galarza):

[mediawiki/extensions/WikiLambda@master] Tokenize search term and aggregate preliminary matches

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

Change #1185073 had a related patch set uploaded (by Genoveva Galarza; author: Genoveva Galarza):

[mediawiki/extensions/WikiLambda@master] Change no results message and add calls to action

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

Change #1184531 merged by jenkins-bot:

[mediawiki/extensions/WikiLambda@master] Tokenize search term and aggregate preliminary matches

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

Change #1185073 merged by jenkins-bot:

[mediawiki/extensions/WikiLambda@master] Change no results message and add calls to action

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

@gengh Thanks for working on this. I see you did V2 which is great.
It will be preferable if the links open in another page and for View all functions to link to https://www.wikifunctions.org/wiki/Wikifunctions:Catalogue instead. But I can work with current version for the test, my suggested changes are not urgent.