This file records the manual screen-reader acceptance check for beta releases. Automated tests cover focus policy, labels, localisation, and review state logic, but they cannot verify actual screen-reader speech.
Target Environment
- Platform: Windows 11 25H2, AMD64, build 26200.8246
- Screen reader: NVDA 2025.3.3
- Application revision: current tip at the time of each beta readiness check
- Languages checked: English and Spanish
- Galician note: Galician was added after this acceptance check and still needs the same manual screen-reader validation before it is treated as accepted.
- Input method: keyboard only
Accepted Behaviour
Screen Reader and Keyboard
- On startup, focus lands on the ready-screen summary.
- The ready-screen summary reports deck size, scheduled cards, minimum session size, and the review database path.
- If minimum-fill cards are included, the ready-screen summary reports the due count in parentheses after the scheduled count.
- The prompt list is reachable from the keyboard and supports arrow-key navigation.
- Ready-list filtering and sorting remain reachable without trapping focus.
- Ready-list filtering, sorting, card editing, and reverse-card changes keep the same card selected when that card remains visible; adding a card selects the newly added card; deleting a card selects the next visible card in the current list order.
- Pressing Alt+Enter on a selected prompt-list item opens the card details dialogue.
Alt-Sstarts a scheduled pass from the ready screen in English.Alt-Mstarts a scheduled pass from the ready screen in Spanish.Alt-Tstarts an unscheduled full-deck pass from the ready screen in English.Alt-Fstarts an unscheduled full-deck pass from the ready screen in Spanish.Alt-Qquits from the ready screen in English.Alt-Squits from the ready screen in Spanish.Alt-Aopens the add-card dialogue in English.Alt-Dopens the add-card dialogue in Spanish.Alt-Eopens the edit-card dialogue for the selected card.Deleteopens removal for the selected card when focus is in the prompt list.Ctrl-Fflags or unflags the selected prompt-list card, and flags or unflags the current card during review.- The prompt-list context menu and Cards menu expose Flag/Unflag for the selected card, and review exposes a tabbable Flag/Unflag button after the confidence and recall rating buttons.
- Add, edit, remove, options, and statistics dialogues expose usable labels, focus order, and keyboard paths.
- Pressing Enter accepts the options dialogue when appropriate.
- Pressing Enter activates Continue on the statistics dialogue.
- During review, prompt text is focusable before the pre-response rating.
- Number keys
1through4activate the pre-response rating controls. - Space activates Reveal Response and skips the pre-response rating.
- Response text is focusable before the recall feedback rating.
- Number keys
1through4activate the recall feedback controls. eopens the edit-card dialogue after the response is revealed, and focus returns to the previously focused post-response control afterwards.0ends the current pass early from either rating phase.- After Continue from pass statistics, focus returns to the prompt list.
- English and Spanish UI strings are understandable and retain the expected keyboard paths.
Sighted Low-Vision Use
The visual-accessibility pass should be checked with the application in both ordinary light/dark Windows themes and Windows high contrast themes. Cosimo should keep native widget colours rather than hard-coded foreground or background colours, so system contrast settings remain in control.
- Text, list, and review controls should remain legible at the default Windows text scale and at increased text scale.
- The prompt and response areas should be close enough together during review that a magnifier user does not need excessive vertical navigation between the active question, response, and rating controls.
- Rating controls should be grouped in a compact grid with stable tab order:
0,1,2,3,4, then the secondary review actions. - On a maximised window, rating controls should remain clustered rather than stretching across the whole display, so a magnifier user does not need to scan from the far left to the far right to find related actions.
- Review buttons should have larger hit targets and should not rely on colour alone to communicate meaning.
- Main-window controls should remain usable when the window is maximised and when inspected through a screen magnifier.
- The ready-screen top status line should remain short enough to fit ordinary window widths; longer review database details belong in the ready summary.
- Statistics, card details, and learning dashboard dialogues should use the same larger report text and button targets while retaining native colours.
Accepted Known Issue
When tabbing or shift-tabbing into the ready-screen prompt list, NVDA may announce the selected item twice. Arrow-key navigation inside the list, selection, editing, removal, and review startup remain functional. This is accepted for the beta as a native list-control announcement defect rather than a blocker.
Release Rule
Any regression in keyboard-only operation, focus order, accessible naming, dialogue acceptance, rating shortcuts, or the accepted screen-reader flow should block the beta until fixed or explicitly recorded here as an accepted known issue. New language flows should receive the same manual check before release.