Page MenuHomePhabricator

[User Story US-9] Reader searches in their language (Android)
Closed, ResolvedPublic2 Estimated Story Points

Description

User Story

  • As a reader in French, Arabic, or Japanese
  • I want Dive to search and answer in my language
  • So that the results are usable

Where in the flow: Language selection on the search screen; language drives which content is searched and which copy is shown.

Acceptance criteria

  • The language in effect for Dive is the language the reader has selected for search, with no separate Dive-only language switch.

[] Changing language while the sheet is open cancels the in-flight request and re-queries in the new language.
TS: The current design means the user must dismiss the semantic search results sheet before they can switch languages.

  • Arabic renders right-to-left throughout onboarding, the entry point, the explainer modal, the sheet, the passage cards — including the multi-level trail and its separators — the attribution row, and both feedback surfaces.
  • Japanese passages, trails, and headings wrap and truncate following Japanese line-break rules rather than breaking on spaces.
  • French diacritics and Arabic shaping are preserved through highlighting and truncation.
  • Language is recorded on every logged event in the funnel.

Notes and open questions

[] The three-level trail ("Cat | Senses | Vision") gets long. Confirm how it truncates in Japanese and how the order and separators reverse in Arabic.
TS: Per our latest sync, we will only show a two-level trail (Article title and whatever section article is in, returned from the semantic search API.)

  • Onboarding needs a localised worked example per language — see US-2.

Out of scope

Cross-language search (querying in one language and getting passages from another).

Design

N/A

Event Timeline

ABendall-WMF renamed this task from [User Story] Reader searches in their language to [User Story US-9] Reader searches in their language.Sep 8 2026, 7:56 PM

Eng sync:

Changing language while the sheet is open cancels the in-flight request and re-queries in the new language.

We don't start a semantic search request until the user taps "Find", then the modal appears and the search kicks off. So they cannot change language while an in-flight request happens. If the bottom sheet is open, you cannot change your language, you must dismiss the modal first.

If they switch to a different language in the experiment, the entry point will appear under the new language. If they switch to a different language not in the experiment, the entry point would not appear.

Tsevener set the point value for this task to 2.Sep 10 2026, 9:24 PM

That was the design intention as well: the bottom sheet blocks users from changing the language, so I am aligned with the experience as described by Toni. Curious if Abi and Jaz intended something different after reading this requirement line.

Tsevener renamed this task from [User Story US-9] Reader searches in their language to [User Story US-9] Reader searches in their language (Android).Sep 16 2026, 10:22 PM
Tsevener updated the task description. (Show Details)

Talked to Jaz via Slack about this AC line:

Changing language while the sheet is open cancels the in-flight request and re-queries in the new language.

We won't have language switching once sheet is open (as per mockup) so it is okay to remove this AC.

Seddon raised the priority of this task from Medium to High.Sep 28 2026, 11:58 AM

Moved to blocked for now. Once we have more translations for the target languages, we can move this back to design review.

The translation is in the latest alpha. Please download the latest alpha to see the translations

https://github.com/wikimedia/apps-android-wikipedia/releases/tag/latest


  1. Please add one of the target languages ar, ja, fr
  2. Go to the developer settings and make sure semantic-search-phase-2 is 1
ABorbaWMF added subscribers: SNowick_WMF, ABorbaWMF.

Testing on 50612-alpha-2026-10-19
Tested on:
Pixel 8, Android 16
Galaxy A36, Android 15

Requirement✅❓❌Notes
The language in effect for Dive is the language the reader has selected for search, with no separate Dive-only language switch.✅Works as expected
Arabic renders right-to-left throughout onboarding, the entry point, the explainer modal, the sheet, the passage cards — including the multi-level trail and its separators — the attribution row, and both feedback surfaces.✅Works as expected
Japanese passages, trails, and headings wrap and truncate following Japanese line-break rules rather than breaking on spaces.✅Works as expected
French diacritics and Arabic shaping are preserved through highlighting and truncation.✅Works as expected
Language is recorded on every logged event in the funnel.I assume this is fine, but should be checked by @SNowick_WMF