Page MenuHomePhabricator

[L][Android user story] Top-read topics slides & empty state
Open, HighPublic1 Estimated Story Points

Assigned To
Authored By
HNordeenWMF
Sep 18 2026, 5:55 PM
Referenced Files
F111828072: Screenshot_20261102-150215 (1).png
Mon, Nov 2, 9:05 PM
F111828071: Screenshot_20261102-150210 (1).png
Mon, Nov 2, 9:05 PM
F111828070: Screenshot_20261102-150159 (1).png
Mon, Nov 2, 9:05 PM
F111828073: Screenshot_20261102-150156 (1).png
Mon, Nov 2, 9:05 PM
F111429932: 2026-10-30_10-31-52.webm
Fri, Oct 30, 5:41 PM
F111429533: 2026-10-30_10-27-55.webm
Fri, Oct 30, 5:41 PM
F111427884: 2026-10-30_10-17-52.webm
Fri, Oct 30, 5:41 PM
F111425420: 2026-10-30_10-05-53.webm
Fri, Oct 30, 5:41 PM

Description

Background

In 2025, Year in Review's personalized flow was built around visits, saved articles, time spent, articles read, edits, edit views, geography, categories, reading patterns, and top articles. For 2026, Topics is a new datapoint added to give readers a clearer picture of what they read about, not just how much.

User Story

As a Wikipedia reader, I want to see the topics I read about most this year, so that I can reflect on my interests and feel like Year in Review truly reflects my reading habits.

Requirements

Topics core mechanic

  • Topic taxonomy and all translations reused from Home feed "For You" personalization work
  • Each topic area should include a unique illustration to represent it
  • If a user clears their reading history, the cached data for these slides should also be cleared

Slide #1 Top Topic

  • Calculate the single topic that the user has the most articles read under (if a tie, randomly select one)
  • Supporting text contains
    • 2 article tiles that belong to that topic
    • Total count of articles
    • Relevant topic sentence for that Topic
  • Eligibility
    • User has at least 5 articles read in 2026
    • User has at least 3 articles that share a one topic that they read during the 2026 data period
    • If a user is not eligible for this slide, show the empty state

Empty state

  • Show empty state slide with illustration
  • Empty state copy (Check most recent in copy doc)
    • Your #1 topic of 2026 is... all of them
    • With so many interests, there's no one topic that defined your reading habits.

Slide #2 Other top-read topics

  • Show up to 3 additional topics that the user has read during 2026
  • Other topics should not overlap with the top-read topic
  • Each topic area should include a unique illustration to represent it
  • Each topic displays its article count (e.g. "Biology: 42 articles")
  • Eligibility
    • User is eligible for Slide #1
    • User has 2 additional topics where they read multiple articles under each one (2 or more articles that share a topic)
    • If a user only has 2 additional topics to display, show those.
    • Suppress this slide if they only have 1 additional topic, or no additional topics.

Design

  • Folder with illustration assets for each Topic

Copy

Rows 8 and 9 https://docs.google.com/spreadsheets/d/1O6x3_19wRpkp6IZ03CIjQDhSYaS4r9ETCzIhARjqfUQ/edit?gid=2062766363#gid=2062766363
Topic sentences: https://docs.google.com/spreadsheets/d/1O6x3_19wRpkp6IZ03CIjQDhSYaS4r9ETCzIhARjqfUQ/edit?gid=1287524835#gid=1287524835


Derived Requirements

  • Show the user’s most-read topic when their 2026 history contains at least five articles, including at least three sharing one topic. Display its unique illustration, two article tiles belonging to that topic, the topic’s article count, and the approved topic sentence; randomly select a winner when topics tie, and show the approved illustrated empty state when eligibility is not met.
  • Show two or three additional qualifying topics when at least two other topics each contain two or more read articles, excluding the selected top topic and displaying each topic’s count and unique illustration. Reuse the Home feed’s topic names and translations, and remove cached topic results when reading history is cleared.

Test Steps

Test Case 1: Verify the top topic, article content, count, and illustration

  1. Prepare at least five read articles, with four assigned to one verified topic and no other topic having an equal or greater count.
  2. Open Activity → Year in Review.
  3. Navigate to the Top Topic slide.
  4. Check that the displayed topic matches the topic containing four articles.
  5. Check that both displayed article tiles belong to that topic.
  6. Check that the supporting text reports four articles.
  7. Compare the topic sentence with the approved sentence for that topic.
  8. Compare the illustration with the approved asset for that topic.
  9. Repeat with prepared histories covering other supported topics.
  10. ✅❓❌⬜ AC1: Each tested Top Topic slide displays the highest-count topic with two matching article tiles, its correct article count, approved topic sentence, and designated illustration.

Test Case 2: Verify tied top topics produce a valid winner

  1. Prepare a history containing two topics with three articles each and no topic with a greater count.
  2. Open Year in Review and inspect the Top Topic slide.
  3. Check that the selected topic is one of the tied topics.
  4. Check that its article tiles, count, sentence, and illustration match the selected topic.
  5. Repeat across independently generated experiences using the supported reset or equivalent profiles.
  6. ✅❓❌⬜ AC2: Tied topics can each be selected as the top topic across independent experiences, with content matching the selected winner.

Test Case 3: Verify eligibility and the illustrated empty state

  1. Prepare a history containing four articles, including three sharing a topic.
  2. Open Year in Review and inspect the Top Topic slide.
  3. Repeat with five articles but no topic shared by three articles.
  4. Check that both scenarios display the empty-state illustration and these texts:
    • “Your #1 topic of 2026 is... all of them”
    • “With so many interests, there's no one topic that defined your reading habits.”
  5. Repeat with five articles, including three sharing one topic.
  6. Check that the populated Top Topic slide appears.
  7. ✅❓❌⬜ AC3: The populated Top Topic slide appears only when both eligibility conditions are met; otherwise the approved illustrated empty state appears.

Test Case 4: Verify additional-topic eligibility, counts, and maximum list size

  1. Prepare a history eligible for the Top Topic slide with no other topic containing two articles.
  2. Open Year in Review and check that the additional-topics slide is absent.
  3. Repeat with only one additional topic containing two articles.
  4. Check that the additional-topics slide remains absent.
  5. Repeat with exactly two additional topics containing two or more articles each.
  6. Check that the slide displays both topics with their correct counts and designated illustrations.
  7. Repeat with three additional qualifying topics and check that all three appear.
  8. Repeat with four additional qualifying topics and check that no more than three appear.
  9. Check that every displayed additional topic differs from the selected top topic and has at least two articles.
  10. ✅❓❌⬜ AC4: The additional-topics slide appears only with at least two qualifying additional topics and displays two or three distinct topics, excluding the top topic, with correct counts and illustrations.

Test Case 5: Verify clearing history removes cached topic results

  1. Prepare a qualifying history and open both populated topic slides.
  2. Record their topics, article tiles, and counts.
  3. Exit Year in Review.
  4. Clear the app’s reading history using its history-deletion control.
  5. Confirm that History is empty.
  6. Reopen Year in Review through a supported route, if still available, and check that the previous populated topic results are absent.
  7. Prepare a new qualifying 2026 history with different topics and articles, restoring personalized eligibility if necessary.
  8. Refresh Year in Review and inspect both topic slides.
  9. Check that all displayed results reflect the new history without retaining old articles or counts.
  10. ✅❓❌⬜ AC5: Clearing reading history removes the previous topic results, and subsequently generated slides reflect only the new reading history.

Test Case 6: Verify topic names and translations match Home feed personalization

  1. Open Home feed For You personalization and record the supported topic names in English.
  2. Compare corresponding topic names on the Year in Review slides.
  3. Switch to another supported language using the app’s applicable language setting.
  4. Compare the translated topic names in Year in Review with the corresponding Home feed personalization names.
  5. ✅❓❌⬜ AC6: Year in Review uses the same topic names and translations as Home feed personalization in each tested language.

QA Results - 50614-alpha-2026-10-29

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes
HNordeenWMF raised the priority of this task from Medium to High.Sep 18 2026, 11:39 PM
WRai-WMF renamed this task from [Android user story] Top-read topics slides & empty state to [L][Android user story] Top-read topics slides & empty state.Sep 21 2026, 2:05 PM
WRai-WMF set the point value for this task to 8.Sep 23 2026, 2:18 PM

@SChekfa-WMF please update the task once we have the Topics variables from Maryyann

HNordeenWMF lowered the priority of this task from High to Medium.Sep 29 2026, 6:04 PM
HNordeenWMF raised the priority of this task from Medium to High.Oct 2 2026, 3:14 PM

blocked; waiting for asset folder from sharon

HNordeenWMF lowered the priority of this task from High to Medium.Oct 6 2026, 9:50 PM
HNordeenWMF raised the priority of this task from Medium to High.Oct 6 2026, 10:09 PM
HNordeenWMF added a subscriber: SChekfa-WMF.
Mazevedo changed the point value for this task from 8 to 5.Oct 7 2026, 4:52 PM
HNordeenWMF lowered the priority of this task from High to Medium.Oct 7 2026, 5:09 PM

Each topic area should include a unique illustration to represent it

@HNordeenWMF Are these illustrations somewhere?

Still awaiting the finals, please use placeholders for now

ABorbaWMF subscribed.

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

Requirement✅❓❌Notes
Topics core mechanic
Topic taxonomy and all translations reused from Home feed "For You" personalization work✅Works as expected
Each topic area should include a unique illustration to represent it✅Works as expected
If a user clears their reading history, the cached data for these slides should also be cleared✅Works as expected
Slide #1 Top Topic
Calculate the single topic that the user has the most articles read under (if a tie, randomly select one)✅Works as expected
Supporting text contains
2 article tiles that belong to that topic✅Works as expected
Total count of articles✅Works as expected
Relevant topic sentence for that Topic✅Works as expected
Eligibility
User has at least 5 articles read in 2026✅Works as expected
User has at least 3 articles that share a one topic that they read during the 2026 data period✅Works as expected
If a user is not eligible for this slide, show the empty state✅Works as expected
Empty state
Show empty state slide with illustration✅Works as expected
Empty state copy (Check most recent in copy doc)✅Works as expected
Your #1 topic of 2026 is... all of them
With so many interests, there's no one topic that defined your reading habits.✅Works as expected
Slide #2 Other top-read topics
Show up to 3 additional topics that the user has read during 2026✅Works as expected
Other topics should not overlap with the top-read topic✅Works as expected
Each topic area should include a unique illustration to represent it✅Works as expected
Each topic displays its article count (e.g. "Biology: 42 articles")✅Works as expected
Eligibility
User is eligible for Slide #1✅Works as expected
User has 2 additional topics where they read multiple articles under each one (2 or more articles that share a topic)✅Works as expected
If a user only has 2 additional topics to display, show those.✅Works as expected
Suppress this slide if they only have 1 additional topic, or no additional topics.✅Works as expected

@Dbrant @HNordeenWMF @ABorbaWMF Please review AC3-AC6, thanks!

Test Result - 50614-alpha-2026-10-29

Status: ✅ PASS / ❓ Need More Info / ❌ FAIL
Environment: 50614-alpha-2026-10-29
OS: Record Android version
Browser: NA
Device: Record Android device
Emulated Device: BS: Galaxy S26 Ultra; Pixel 10 XL Pro

Test Artifact(s):

Test Steps

Test Case 1: Verify the top topic, article content, count, and illustration

  1. Prepare at least five read articles, with four assigned to one verified topic and no other topic having an equal or greater count.
  2. Open Activity → Year in Review.
  3. Navigate to the Top Topic slide.
  4. Check that the displayed topic matches the topic containing four articles.
  5. Check that both displayed article tiles belong to that topic.
  6. Check that the supporting text reports four articles.
  7. Compare the topic sentence with the approved sentence for that topic.
  8. Compare the illustration with the approved asset for that topic.
  9. Repeat with prepared histories covering other supported topics.
  10. ✅*AC1: Each tested Top Topic slide displays the highest-count topic with two matching article tiles, its correct article count, approved topic sentence, and designated illustration.**

Personal

HistoryTop TopicTopic DocVideo
2026-10-29_14-54-00.png (631×1,190 px, 267 KB)
2026-10-29_14-48-17.png (666×1,201 px, 231 KB)
2026-10-29_14-52-25.png (1,693×203 px, 59 KB)

Play Ground

Top TopicRunner Up
2026-10-29_15-32-18.png (1,368×155 px, 38 KB)
2026-10-29_15-01-28.png (620×1,198 px, 224 KB)
2026-10-29_15-02-01.png (629×1,190 px, 185 KB)

Test Case 2: Verify tied top topics produce a valid winner

  1. Prepare a history containing two topics with three articles each and no topic with a greater count.
  2. Open Year in Review and inspect the Top Topic slide.
  3. Check that the selected topic is one of the tied topics.
  4. Check that its article tiles, count, sentence, and illustration match the selected topic.
  5. Repeat across independently generated experiences using the supported reset or equivalent profiles.
  6. ✅AC2: Tied topics can each be selected as the top topic across independent experiences, with content matching the selected winner.
HistoryTop TopicTopic DocVideo
2026-10-29_15-32-18.png (1,368×155 px, 38 KB)
2026-10-29_15-29-33.png (645×1,206 px, 282 KB)
2026-10-29_15-32-46.png (664×1,209 px, 259 KB)

Test Case 3: Verify eligibility and the illustrated empty state

  1. Prepare a history containing four articles, including three sharing a topic.
  2. Open Year in Review and inspect the Top Topic slide.
  3. Repeat with five articles but no topic shared by three articles.
  4. Check that both scenarios display the empty-state illustration and these texts:
    • “Your #1 topic of 2026 is... all of them”
    • “With so many interests, there's no one topic that defined your reading habits.”
  5. ❌ AC3: The populated Top Topic slide appears only when both eligibility conditions are met; otherwise the approved illustrated empty state appears.
  • Top Topic slide appears with less then 5
❌Top Slide- 4 Articles✅Empty State- No share Topic

Test Case 4: Verify additional-topic eligibility, counts, and maximum list size

  1. Prepare a history eligible for the Top Topic slide with no other topic containing two articles.
  2. Open Year in Review and check that the additional-topics slide is absent.
  3. Repeat with only one additional topic containing two articles.
  4. Check that the additional-topics slide remains absent.
  5. Repeat with exactly two additional topics containing two or more articles each.
  6. Check that the slide displays both topics with their correct counts and designated illustrations.
  7. Repeat with three additional qualifying topics and check that all three appear.
  8. Repeat with four additional qualifying topics and check that no more than three appear.
  9. Check that every displayed additional topic differs from the selected top topic and has at least two articles.
  10. ❌ AC4: The additional-topics slide appears only with at least two qualifying additional topics and displays two or three distinct topics, excluding the top topic, with correct counts and illustrations.
  • a. Cat, Dog, Tiger, Lion was under Biology, as seen in AC1 but it's showing up as General Science
  • b. Runner up slide- Topics are mixed up
❌ No qualifying additional Topics❌ One qualifying additional topicTwo qualifying additional topicsThree qualifying additional topicsFour qualifying additional topics

Test Case 5: Verify clearing history removes cached topic results

  1. Prepare a qualifying history and open both populated topic slides.
  2. Record their topics, article tiles, and counts.
  3. Exit Year in Review.
  4. Clear the app’s reading history using its history-deletion control.
  5. Confirm that History is empty.
  6. Reopen Year in Review through a supported route, if still available, and check that the previous populated topic results are absent.
  7. Prepare a new qualifying 2026 history with different topics and articles, restoring personalized eligibility if necessary.
  8. Refresh Year in Review and inspect both topic slides.
  9. Check that all displayed results reflect the new history without retaining old articles or counts.
  10. ❌ AC5: Clearing reading history removes the previous topic results, and subsequently generated slides reflect only the new reading history.

Cat, Dog, Tiger, Lion — intended Biology group.
Basketball, Baseball — intended Sports group.
Piano, Guitar — intended Music group.

  • It seems like Cat, Dog, Tiger, Lion gets mixed up between Biology and General Science since it's splitting it. See AC4. Runner up slide should show Sports and Music. General science should not exist since the animals are under Biology
❌original topic results✅Clear History

Pizza, Pasta, Bread, Cheese — intended Food and drink group.
Triangle, Circle — intended Mathematics group.
Car, Train — intended Transportation group.

  • General Science 3 articles is not supposed to exist with the article history shown
❌ Create different topic results

Test Case 6: Verify topic names and translations match Home feed personalization

  1. Open Home feed For You personalization and record the supported topic names in English.
  2. Compare corresponding topic names on the Year in Review slides.
  3. Switch to another supported language using the app’s applicable language setting.
  4. Compare the translated topic names in Year in Review with the corresponding Home feed personalization names.
  5. ❌AC6: Year in Review uses the same topic names and translations as Home feed personalization in each tested language.

Cat, Dog, Tiger, Lion — intended Biology group.
Basketball, Baseball — intended Sports group.
Piano, Guitar — intended Music group.

  • General Science appeared again. It's supposed to be Sports and Music for the runner up slide, not General Science
  • Does other languages work in YiR?
EnglishSpanish

(The "Car" article is, in fact, classified as "General science" 🤯)

Slide #2 Other top-read topics
Show up to 3 additional topics that the user has read during 2026
Other topics should not overlap with the top-read topic

I'm seeing overlap between the two slides (Europe is my top read, and my first on the second slide in the most recent Alpha

Screenshot_20261102-150156 (1).png (1,080×2,400 px, 377 KB)
Screenshot_20261102-150159 (1).png (1,080×2,400 px, 269 KB)
Screenshot_20261102-150210 (1).png (1,080×2,400 px, 259 KB)
Screenshot_20261102-150215 (1).png (1,080×2,400 px, 409 KB)

ideally we can remove that if it's easy @Dbrant or @WRai-WMF

HNordeenWMF raised the priority of this task from Medium to High.Wed, Nov 4, 7:03 PM

This fix may have broken topics - I'm not able to trigger anything but the empty state while recording a demo with enormous reading histories that span topics (built up from "For you" feed)

This should not happen, the fix only removes the duplicates. Is the empty state for all slides or for only topics?

Only for topics! I used to get the actual topics slides with this kind of history in the past, but now I'm having a hard time triggering it. I did a ton of Art articles and Video Game articles from "For you", and Europe articles. https://drive.google.com/file/d/1Sp8LXAtV5X8R-oUbmKeQPLr7AiE-xZ23/view?usp=sharing

I was able to get Topics as normal in the latest alpha! Using that for my demo video

Looks good to me
Testing on 50616-alpha-2026-11-10
Tested on:
Pixel 8, Android 16
Galaxy A36, Android 15