User story & summary
As a new account holder, I want suggested edits matched to my selected interests so that the tasks I see are relevant to me.
Background & research
Parent task: T430058: [EPIC] Account Setup (DE1.3.1 - early onboarding)
Depends on the interest selector task: T432811: Account setup: Create interest selector and storage of interests (DE1.3.1)
The interest selector built in T432811 stores a set of articles/topics. This task connects that stored set to the suggested edits module on the newcomer homepage and to the suggested edits carousel, and defines what newcomers see when they have no stored interests, when their interests return nothing, and when they return a single result.
We should also refer back to T433151: [SPIKE] Investigate suggestion sources for interest picker when there is no seed article (DE1.3.1) as we implement this with real data, so that we have a better understanding on how often the empty pool might happen.
Design
Full account setup flow, including every action that leads to the newcomer homepage:
Newcomer selected interests during account setup
Suggested edits on the newcomer homepage are drawn from those interests. The module counter reflects the size of the matched set ("1 of 4 suggestions"). The module's primary button stays "See all suggestions".
Newcomer has no stored interests (skipped account setup)
Skipping can happen by closing the welcome screen (X on 1/3), or tapping "Go to your Home" on 3/3 without selecting any interest. In all two cases the newcomer lands on the newcomer homepage and the suggested edits module shows the whole unfiltered pool with the counter reflecting the full pool ("1 of 1,174,550 suggestions"). The module's primary button changes from "See all suggestions" to "Select interests".
Stored interests return no suggestions
The module reuses the existing empty state copy: "No suggestions found" and "Select other interests or difficulty levels to find suggested edits." The primary button reads "Select interests".
Stored interests return exactly one suggestion
The single suggestion is shown as-is, with the counter reading "1 of 1 suggestions". The set is not padded with random suggestions.
Reaching the interests dialog
"Select interests" opens the same interest selector UI used in account setup screen 3 of 3, with any stored interests pre-filled as chips and their related articles listed below. For a newcomer with no stored interests, the dialog opens empty with random articles listed. The dialog also reports the size of the resulting set ("4 suggested edits found"). The dialog is also reachable from the "Interests" filter in the suggested edits carousel.
6. Reaching the carousel
Regardless of which label the primary button shows, the suggested edits carousel remains reachable by tapping the suggestion card itself, or the arrow in the "Suggested edits" module header.
Acceptance criteria
For newcomers with stored interests
AC1
- Given I selected interests during account setup
- When I land on the newcomer homepage
- Then the suggested edits module shows suggestions matched to my interests.
AC2
- Given the suggested edits module is showing interest-matched suggestions
- When I view the module
- Then the primary button reads "See all suggestions"
AC3
- Given I am in the suggested edits carousel
- When I tap the "Interests" filter
- Then the interest selector dialog opens with my stored interests pre-filled
AC4
- Given I have changed my interests in the dialog
- When I tap "Done"
- Then the suggested edits set and its counter update to reflect the new interests
For newcomers with no stored interests
AC5
- Given I skipped account setup (closed the welcome screen, or went to Home without selecting an interest)
- When I land on the newcomer homepage
- Then the suggested edits module shows the full unfiltered pool of suggestions and the counter reflects the total pool size
AC6
- Given the suggested edits module is showing the unfiltered pool
- When I view the module
- Then the primary button reads "Select interests"
AC7
- Given the suggested edits module is showing the unfiltered pool
- When I tap "Select interests"
- Then the interest selector dialog opens with no interests selected and random articles listed
Edge cases
AC8
- Given my stored interests return no suggested edits
- When I view the suggested edits module
- Then I see "No suggestions found" and "Select other interests or difficulty levels to find suggested edits.", and the primary button reads "Select interests"
AC9
- Given my stored interests return exactly one suggested edit
- When I view the suggested edits module
- Then that single suggestion is shown and the counter reads "1 of 1 suggestions", with no additional unmatched suggestions added
AC10
- Given the suggested edits module is showing at least one suggestion, with or without stored interests
- When I tap the suggestion card or the arrow in the module header
- Then the suggested edits carousel opens
