Skip to content

Rewrite five foundational lessons in natural Arabic and clear English - #64

Merged
ru44 merged 6 commits into
mainfrom
improve/bilingual-lesson-explanations
Nov 16, 2026
Merged

ru44 merged 6 commits into
mainfrom
improve/bilingual-lesson-explanations

Conversation

@ru44

@ru44 ru44 commented Nov 16, 2026

Copy link
Copy Markdown
Owner

The Arabic and English explanations for five foundational lessons were difficult to follow on a first encounter: literal phrasing, unexplained notation, and descriptions that did not always match the visualization. This PR rewrites place value, negative numbers, fractions and decimals, slope, and derivatives in natural Modern Standard Arabic and plain English.

Each lesson introduces the meaning before notation, uses reproducible slider settings, explains the observation, and makes the mathematical conditions explicit. Corrections include the 396 difference between 743 and 347, negative-number ordering, fraction diagram descriptions, the reduced-denominator condition for terminating decimals, and the local meaning of derivative slope.

The writing guides and lesson scaffold now describe this approach and require checking examples against the visualization and challenge conditions. This is the first reviewed batch: 5 of 390 lessons. The remaining 385 lessons still require individual editorial review.

Six atomic commits: one per bilingual lesson, plus one for authoring guidance. No co-author trailers. Published using gh api, preserving the original local commit SHAs.

Validation:

  • pnpm check: 390 lessons, both languages, zero content problems; all engine, statistics, zeta, and pattern checks passed.
  • pnpm lint: passed.
  • pnpm build: passed.
  • git diff --check: passed.

The build emits a non-failing KaTeX Unicode warning and bundle-size warnings. Diagram descriptions were checked against component source; no browser interaction test was performed.

@ru44 ru44 self-assigned this Nov 16, 2026
@ru44
ru44 merged commit 58e61c0 into main Nov 16, 2026
2 checks passed
@ru44
ru44 deleted the improve/bilingual-lesson-explanations branch November 16, 2026 06:37
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