Skip to content

Reader spec: daily changes 2026-10-19 - #3826

Draft
claude[bot] wants to merge 1 commit into
reader-nextfrom
reader-future/daily-2026-10-19
Draft

claude[bot] wants to merge 1 commit into
reader-nextfrom
reader-future/daily-2026-10-19

Conversation

@claude

@claude claude Bot commented Oct 19, 2026

Copy link
Copy Markdown
Contributor

Requested by Akiva Berger · Slack thread

Before: the spec had no rules for interface language, content language or version stickiness. Every channel section of i18n-a11y and versions was "Not discussed yet.", and the only source was the Feature Atlas, which marks several of these items done although the code does not fully back them.

After: i18n-a11y and versions map the legacy rules (master @ 121350b: interface precedence profile → cookie → country → browser language → English, domain pinning and set-language-cookie, bots, non-Torah sites, the three writers; content language lang/lang<n> → contentLang cookie → Hebrew for a Hebrew interface, else bilingual; version URL params and their correction, client resolution order, profile-first vs cookie-only preferences, the location-based suggestion banner). They also cover what reader-next @ 837d585 ports, its gaps (including two likely bugs: a vhe-only URL loses the preference at TextPanel.tsx:84, and an unknown explicit ven shows no translation instead of the default), legacy behaviour not to port, and open questions. Everything is marked idea; nothing was added to DECISIONS.md. Both areas move baseline → exploring.

How: filled the Summary, Legacy vs new, Dependencies and Risks/Open questions sections (plus Changes from today and Open questions in the product docs), and added a "Legacy behaviour not to port" section, in docs/reader-future/i18n-a11y/{product,architecture}.md and docs/reader-future/versions/{product,architecture}.md. Filled CROSS_CUTTING.md → "Accessibility and languages" with pointers and a list of atlas marks the code does not fully back (RTE-028, RTE-034, SHL-007, VER-014; VER-012's note is stale; SHL-014 is done but the reader-shell baseline says not started). The atlas and BASELINE blocks are unchanged. Code links are pinned to SHAs. The open questions point to the settings registry proposed in PR #3822 by name.


Generated by Claude Code

…s as ideas

i18n-a11y and versions: legacy rules (master @ 121350b) vs reader-next
(@ 837d585) with file:line, gaps, legacy behaviour not to port, and open
questions, all marked idea. CROSS_CUTTING lists atlas marks the code
does not fully back (RTE-028, RTE-034, SHL-007, VER-014, VER-012, SHL-014).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YVk1KuVVM9g2qUYR976dBm

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant