Skip to content

docs: improve translation quality and restore omitted guidance - #78

Merged
abruption merged 1 commit into
mainfrom
docs/translation-quality
Oct 30, 2026
Merged

abruption merged 1 commit into
mainfrom
docs/translation-quality

Conversation

@abruption

@abruption abruption commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

Problem and result

Some translated guides change the meaning or omit constraints from English. A Korean retry-backoff sentence reads like a blocking one-minute sleep; the lifecycle research summary omits collector safeguards and important evidence limits. This PR restores those details, corrects terminology and improves Japanese and English wording.

Closes #77.

Scope and independent review

  • Audited all 61 baseline Markdown documents (43 under docs/) in English, Korean, Japanese and Simplified Chinese, plus three recovery instruction text templates.
  • Revised 18 existing documents and added docs/validation/documentation-translation-audit-20261030.md with complete per-file coverage, terminology guidance and finding dispositions. Simplified Chinese documents were reviewed without forced cosmetic rewrites.
  • GPT-6 Luna subagents independently compared translations and reviewed the final edits. Gemini 3.8 Flash Medium completed both a fresh full-corpus audit and a separate final review of all 18 revised documents, with no required corrections in the final review. Codex checked model suggestions against source; unsupported browser-cause claims and incorrect Markdown-heading suggestions were rejected.
  • The reported “예비군” and “붓기” strings are absent from tracked source at the baseline. Their origin in the rendering experience was not reproduced; verified source defects are corrected here.

Validation

  • git diff --check and python3 scripts/source_manifest.py --check passed.
  • Local Markdown targets and anchors checked across all 62 resulting Markdown files: no missing targets/anchors.
  • Existing fenced command blocks unchanged except the restored Korean lifecycle record, whose blocks now exactly match English.
  • Documentation only. Executable sources, manifest, numerical policies and historical evidence remain unchanged. No deployment or signed release-asset changes. Local runtime suites were not rerun for prose-only changes; PR CI runs the required checks.

CI result

All checks passed at 9b7fff3609f595331609a66d1b3dba92bbc7a7f4: Python 3.11/3.13, Research Python 3.12/3.13, Shell syntax/ShellCheck, Python static checks and GitGuardian. PR is Ready and remains unmerged.

Complete audit record.

@abruption abruption added the documentation Improvements or additions to documentation label Oct 30, 2026
@abruption abruption self-assigned this Oct 30, 2026
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-30T05:35:43.216264Z 9b7fff3 PR opened
🔒 Security Review ✅ Completed 2026-10-30T05:33:43.027422Z 9b7fff3 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@abruption
abruption merged commit 78f6af3 into main Oct 30, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: audit and improve translation quality across all documentation

1 participant