Skip to content

docs: translate current documentation and site UI into Ukrainian - #167

Merged
rmcdaniel merged 10 commits into
mainfrom
docs/i18n-uk
Oct 7, 2026
Merged

rmcdaniel merged 10 commits into
mainfrom
docs/i18n-uk

Conversation

@rmcdaniel

@rmcdaniel rmcdaniel commented Oct 7, 2026 •

Copy link
Copy Markdown
Member

Scope

Complete #161: Ukrainian current documentation and site UI, with English as the default locale. Blogs and versioned 1.x documentation retain the English fallback.

Changes

  • Ukrainian locale at /uk/, language switcher, navigation, footer, search labels and theme messages.
  • All 102 current documentation pages and category metadata translated, along with the homepage, Temporal comparison, CLI installer, protocol tables and interactive simulators.
  • Localized edit links and contributor translation instructions.
  • Unicode-preserving search tokenization, with regression coverage for Ukrainian terms, English API names and serialized index reload.
  • Corrected outdated English guidance encountered during translation, including cancellation and parent-close policies, worker capabilities and runtime registration, sample history/MCP examples, v1 adoption links, drain intent and per-queue flow counters. Cloud HA plans are described as in qualification and unavailable to purchase or provision, matching live pricing. The separately versioned Helm path is linked from Server deployment guidance, and Python's health endpoint is identified as liveness.

Verification

  • All 645 fenced code blocks and 1,029 heading anchors in the 102 translated docs match their current English sources. The comparison preserves both code blocks and all 10 heading anchors.
  • Fresh dependency installation applied all three patches. The Unicode search regression passed. Search inputs also expose translated accessible labels.
  • Clean English and Ukrainian production build passed with strict Markdown, link and anchor checks enabled. Documentation Qualification, Public Boundary and Protocol Specs all passed at 8e2e0ad327ff39a649ffec863bb6f9d250f6e688.
  • Browser checks passed for Ukrainian search, Markdown navigation, locale switching in both directions, the Temporal comparison, CLI installer platform selection, timer simulator, homepage and mobile rendering. No browser runtime exceptions.
  • npm run start -- --locale uk served the translated introduction with HTTP 200 and html lang="uk".
  • Reviewed the locale routing, component translations, dependency patches and search regression. Git whitespace check passed.

Publication

After merge, verify published Ukrainian routes and locale switching, then close #161. Strict broken-link and broken-anchor checks stay enabled.

@rmcdaniel
rmcdaniel marked this pull request as ready for review October 7, 2026 04:09
@rmcdaniel
rmcdaniel merged commit a693e41 into main Oct 7, 2026
4 checks passed
@rmcdaniel
rmcdaniel deleted the docs/i18n-uk branch October 7, 2026 04:09
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.

[docs] Add Ukrainian locale for Durable Workflow 2.0 documentation

2 participants