[PR #2165] [MERGED] docs: move translated READMEs under docs/readme #5069

New issue

Closed

opened 2026-10-31 01:02:23 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-31 01:02:23 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/2165
Author: @aimalexe
Created: 10/12/2026
Status: ✅ Merged
Merged: 10/13/2026
Merged by: @N0zoM1z0

Base: main ← Head: docs/move-translated-readmes

📝 Commits (8)

063e518 docs: move translated READMEs under docs/readme
751f519 fix(docs): update Italian README with correct command path and enhance test cases for product catalog drift
e4140fb fix(docs): integrate translated README migration with main
2fa15fc chore(docs): sync translated README PR with current main
d3eaa71 chore(docs): refresh translated README PR with upstream CI fixes
980554c chore(docs): retain README coverage across current CI scope changes
a0fde44 chore(docs): sync the upstream release preflight regression fix
8d811ed chore(docs): sync the upstream x64 dylib fixture fix

📊 Changes

29 files changed (+1108 additions, -956 deletions)

View changed files

📝 README.md (+1 -1)
📝 docs/.vitepress/config.ts (+1 -0)
📝 docs/readme/README_ar.md (+47 -47)
📝 docs/readme/README_de.md (+47 -47)
📝 docs/readme/README_es.md (+47 -47)
📝 docs/readme/README_fa.md (+50 -50)
📝 docs/readme/README_fr.md (+48 -48)
📝 docs/readme/README_id.md (+51 -51)
📝 docs/readme/README_it.md (+49 -49)
📝 docs/readme/README_ja.md (+47 -47)
📝 docs/readme/README_ko.md (+47 -47)
📝 docs/readme/README_pl.md (+47 -47)
📝 docs/readme/README_pt-BR.md (+47 -47)
📝 docs/readme/README_ru.md (+47 -47)
📝 docs/readme/README_th.md (+47 -47)
📝 docs/readme/README_tr.md (+47 -47)
📝 docs/readme/README_uk.md (+47 -47)
📝 docs/readme/README_vi.md (+47 -47)
📝 docs/readme/README_zh-TW.md (+47 -47)
📝 docs/readme/README_zh.md (+47 -47)

...and 9 more files

📄 Description

Summary

Closes #2141. Thanks @aimalexe for implementing the translated README migration.

Keep English at README.md and move all 18 translations into the docs/readme/ directory confirmed during review. Resolve conflicts against current main while retaining its updated content.

Changes

Update language navigation, relative guide/image/license links and website language inventory/discovery together.
Compare resolved Markdown and HTML destinations against the canonical English README.
Keep translated README changes on the docs/website CI lanes; the existing docs/** cache inputs cover the moved translations.
Check onboarding examples for every language, including Italian. Align its example path with the canonical command.
Correct six existing Persian anchor links to match GitHub's heading IDs, preserving zero-width joiners and heading text. Add regression coverage for these fragments and HTML image paths.
Retain the contributor's original commit and chosen layout; maintainer follow-up integrates current main and the verified corrections.

Validation

Maintainer verification: 195 focused CLI/README/CI tests passed after synchronization.
Independent follow-up on the same HEAD: 203 tests across seven files passed, covering dylib CLI resolution, README consistency, documentation facts, CI classification, JavaScript provenance, release preflight and provider deadlines. These runs overlap; their counts are not additive.
check:fast, docs:check, docs:build, format:check and git diff --check passed.
Full website check with Python 3.12 passed: 19 languages, 325 HTML pages, 20,793 local references and 12 maintenance regressions.
README migration checked with a Markdown parser: prose and resolved file targets preserved, apart from the explicitly corrected Italian command placeholder and Persian link fragments.
19 actual GitHub GFM renders checked; immutable GitHub page heading IDs used for README anchors. 1,501 local README references and 399 authored fragments verified, no problems. Unchanged external links were not audited for availability.
Documentation cache invalidation checked by changing only an Italian guide fragment, then restoring the original bytes.

Compatibility and scope

Old root translation URLs move to docs/readme/README_<language>.md; no duplicate compatibility files are retained. English remains canonical. Translation wording is unchanged, and no runtime CLI/MCP contract, provider authority, dependencies or release metadata are changed. Real analysis engines are not required for this documentation migration.

Attribution and current CI

Our sync commits retain the anonymous primary-author email and Kaoru0822 / factory-droid co-author trailers. The final squash body also preserves Aimal Khan credit.

Current head: 8d811ed33, synchronized with main fb28ec153. Includes the upstream x64 fixture correction from #2755: the dylib regression retains both same-named ARM64 slices and adds a plain x86_64 slice for target admission. The four release-preflight cases are also repaired by the previously integrated main fix. No runtime or workflow changes are introduced relative to main; the documentation migration remains 29 files.

Maintainer validation after synchronization: 195 focused tests, check:fast, format:check, and git diff --check passed using Node 24.18.0 and npm 11.16.0. The independent 203-test follow-up peaked at 1.34 GiB with a two-core CPU budget; its refreshed README link check also passed. The previous website and documentation checks above remain evidence for the unchanged migration content; the new CI run validates the combined tree.

Current CI: https://github.com/morluto/rea/actions/runs/38392020827 . Fork workflows are approved. Static, documentation, build, website, provider and five portable test shards pass. An earlier shard-3 run hit the existing ProviderDeadline timing assertion (0 ms expected, 1 ms received). The targeted rerun passed all 1,743 tests at the exact same checkout; both the test and implementation match main. All six portable shards now pass, and the required aggregates are queued. The migration remains unchanged.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/morluto/rea/pull/2165 **Author:** [@aimalexe](https://github.com/aimalexe) **Created:** 10/12/2026 **Status:** ✅ Merged **Merged:** 10/13/2026 **Merged by:** [@N0zoM1z0](https://github.com/N0zoM1z0) **Base:** `main` ← **Head:** `docs/move-translated-readmes` --- ### 📝 Commits (8) - [`063e518`](https://github.com/morluto/rea/commit/063e518b0a61f756f0b15762eca22e6ed4f0a9b6) docs: move translated READMEs under docs/readme - [`751f519`](https://github.com/morluto/rea/commit/751f5199f6cbd105c39df4ba10a30502fd1066d5) fix(docs): update Italian README with correct command path and enhance test cases for product catalog drift - [`e4140fb`](https://github.com/morluto/rea/commit/e4140fb3f9616f45cb0fb6f725d27073a3b8a7de) fix(docs): integrate translated README migration with main - [`2fa15fc`](https://github.com/morluto/rea/commit/2fa15fc27155850a75958a5661a4c448627d835d) chore(docs): sync translated README PR with current main - [`d3eaa71`](https://github.com/morluto/rea/commit/d3eaa713049e0648a9f7baa6ad3e3334ffd38d06) chore(docs): refresh translated README PR with upstream CI fixes - [`980554c`](https://github.com/morluto/rea/commit/980554cd6d70e240ce30ddcad12272326b9e7800) chore(docs): retain README coverage across current CI scope changes - [`a0fde44`](https://github.com/morluto/rea/commit/a0fde447fa6b6b2e6ce0b4c6e30af6f0fd30f5ec) chore(docs): sync the upstream release preflight regression fix - [`8d811ed`](https://github.com/morluto/rea/commit/8d811ed330aa4ccc5646409532b0e41f8d7a1501) chore(docs): sync the upstream x64 dylib fixture fix ### 📊 Changes **29 files changed** (+1108 additions, -956 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -1) 📝 `docs/.vitepress/config.ts` (+1 -0) 📝 `docs/readme/README_ar.md` (+47 -47) 📝 `docs/readme/README_de.md` (+47 -47) 📝 `docs/readme/README_es.md` (+47 -47) 📝 `docs/readme/README_fa.md` (+50 -50) 📝 `docs/readme/README_fr.md` (+48 -48) 📝 `docs/readme/README_id.md` (+51 -51) 📝 `docs/readme/README_it.md` (+49 -49) 📝 `docs/readme/README_ja.md` (+47 -47) 📝 `docs/readme/README_ko.md` (+47 -47) 📝 `docs/readme/README_pl.md` (+47 -47) 📝 `docs/readme/README_pt-BR.md` (+47 -47) 📝 `docs/readme/README_ru.md` (+47 -47) 📝 `docs/readme/README_th.md` (+47 -47) 📝 `docs/readme/README_tr.md` (+47 -47) 📝 `docs/readme/README_uk.md` (+47 -47) 📝 `docs/readme/README_vi.md` (+47 -47) 📝 `docs/readme/README_zh-TW.md` (+47 -47) 📝 `docs/readme/README_zh.md` (+47 -47) _...and 9 more files_ </details> ### 📄 Description ## Summary Closes #2141. Thanks @aimalexe for implementing the translated README migration. Keep English at `README.md` and move all 18 translations into the `docs/readme/` directory confirmed during review. Resolve conflicts against current main while retaining its updated content. ## Changes - Update language navigation, relative guide/image/license links and website language inventory/discovery together. - Compare resolved Markdown and HTML destinations against the canonical English README. - Keep translated README changes on the docs/website CI lanes; the existing `docs/**` cache inputs cover the moved translations. - Check onboarding examples for every language, including Italian. Align its example path with the canonical command. - Correct six existing Persian anchor links to match GitHub's heading IDs, preserving zero-width joiners and heading text. Add regression coverage for these fragments and HTML image paths. - Retain the contributor's original commit and chosen layout; maintainer follow-up integrates current main and the verified corrections. ## Validation - Maintainer verification: 195 focused CLI/README/CI tests passed after synchronization. - Independent follow-up on the same HEAD: 203 tests across seven files passed, covering dylib CLI resolution, README consistency, documentation facts, CI classification, JavaScript provenance, release preflight and provider deadlines. These runs overlap; their counts are not additive. - `check:fast`, `docs:check`, `docs:build`, `format:check` and `git diff --check` passed. - Full website check with Python 3.12 passed: 19 languages, 325 HTML pages, 20,793 local references and 12 maintenance regressions. - README migration checked with a Markdown parser: prose and resolved file targets preserved, apart from the explicitly corrected Italian command placeholder and Persian link fragments. - 19 actual GitHub GFM renders checked; immutable GitHub page heading IDs used for README anchors. 1,501 local README references and 399 authored fragments verified, no problems. Unchanged external links were not audited for availability. - Documentation cache invalidation checked by changing only an Italian guide fragment, then restoring the original bytes. ## Compatibility and scope Old root translation URLs move to `docs/readme/README_<language>.md`; no duplicate compatibility files are retained. English remains canonical. Translation wording is unchanged, and no runtime CLI/MCP contract, provider authority, dependencies or release metadata are changed. Real analysis engines are not required for this documentation migration. ## Attribution and current CI Our sync commits retain the anonymous primary-author email and Kaoru0822 / factory-droid co-author trailers. The final squash body also preserves Aimal Khan credit. Current head: `8d811ed33`, synchronized with main `fb28ec153`. Includes the upstream x64 fixture correction from #2755: the dylib regression retains both same-named ARM64 slices and adds a plain x86_64 slice for target admission. The four release-preflight cases are also repaired by the previously integrated main fix. No runtime or workflow changes are introduced relative to main; the documentation migration remains 29 files. Maintainer validation after synchronization: 195 focused tests, `check:fast`, `format:check`, and `git diff --check` passed using Node 24.18.0 and npm 11.16.0. The independent 203-test follow-up peaked at 1.34 GiB with a two-core CPU budget; its refreshed README link check also passed. The previous website and documentation checks above remain evidence for the unchanged migration content; the new CI run validates the combined tree. Current CI: https://github.com/morluto/rea/actions/runs/38392020827 . Fork workflows are approved. Static, documentation, build, website, provider and five portable test shards pass. An earlier shard-3 run hit the existing `ProviderDeadline` timing assertion (0 ms expected, 1 ms received). The targeted rerun passed all 1,743 tests at the exact same checkout; both the test and implementation match main. All six portable shards now pass, and the required aggregates are queued. The migration remains unchanged. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-31 01:02:23 +00:00