Skip to content

docs: add missing sections to ES/JA/RU/ZH README variants (V4-16) - #9

Merged
lukisch merged 1 commit into
masterfrom
v4/readme-parity-variants-20260731
Jul 31, 2026
Merged

docs: add missing sections to ES/JA/RU/ZH README variants (V4-16)#9
lukisch merged 1 commit into
masterfrom
v4/readme-parity-variants-20260731

Conversation

@lukisch

@lukisch lukisch commented Jul 31, 2026

Copy link
Copy Markdown
Collaborator

Kontext

Handoff KIMI-V4-WORKSTATION-LG-20260731-01, Arbeitspaket V4-16 (Sprachparität). Der Language-Parity-Report (docs/language-parity-report.WORKSTATION-LG.20260730.json, ellmos-development-system) meldete für die Varianten ES/JA/RU/ZH-Hans je heading-structure-drift, fenced-code-drift, link-target-drift. Die DE-Variante ist bereits paritätisch (nur by-design-Lokalisierungen).

Befund (unabhängig nachgemessen, fence-bereinigt)

Allen vier Varianten fehlten gegenüber der englischen Leitfassung dieselben drei Sektionen und zwei Badges:

  • ## Start Here (Tabelle + NOTE-Block mit zwei llms.txt-Links)
  • ## Architecture & Data Flow (Mermaid-Diagramm)
  • ## Discovery Context (Suchphrasen)
  • Badges tests-41 Python | 45 Node und llms.txt

Änderung (4 Dateien, +164)

Fehlende Sektionen/Badges als getreue Übersetzungen ergänzt — nach den Konventionen der bereits verifizierten deutschen Variante: übersetzte Mermaid-Knotentexte, Suchphrasen bewusst englisch belassen, lokalisiertes llms.txt-Badge (disponible/利用可能/доступен/可用), Tabellenzeile verweist auf die englische Leitfassung. Kein bestehender Inhalt geändert.

Verifikation

  • Strukturparität nachgemessen: 16/16 reale Heading-Levels und identische fenced code blocks für alle fünf Varianten; Linkziele identisch bis auf dieselben by-design-Lokalisierungen, die auch die verifizierte DE-Variante hat (Switcher-Cross-Links, lokalisiertes llms.txt-Badge).
  • python -m pytest -q41 passed
  • node --test web_publisher/tests/publisher.test.mjs45 passed (deckt sich mit den Badge-Angaben)
  • git diff --check → sauber

Nonclaims

Natürlichsprachliche Semantik bleibt not-machine-proven (Contract-Vorbehalt); Übersetzungen folgen der DE-Konvention, wurden aber nicht von Muttersprachlern geprüft. Keine Änderung an der EN-Leitfassung oder der DE-Variante. Kein Merge durch den Ersteller — Abnahme/Merge obliegt unabhängiger Prüfung bzw. User-Entscheidung.

Restore maintained-variant parity with the canonical English README
(language parity report docs/language-parity-report.WORKSTATION-LG.20260730.json
in ellmos-development-system flagged heading/fence/link drift for all
four variants).

Each of the four variants lacked the Start Here, Architecture & Data
Flow (mermaid) and Discovery Context sections plus the tests and
llms.txt badges. Added as faithful translations following the verified
German variant's conventions (translated mermaid node labels, search
phrases kept in English, localized llms.txt badge, table row pointing
to the English guide).

Structural parity after the change (fence-aware measurement):
16/16 real heading levels and identical fenced code blocks for all
five variants; link targets identical except the same by-design
localizations the verified German variant already has (switcher
cross-links, localized llms.txt badge).

Handoff KIMI-V4-WORKSTATION-LG-20260731-01.

Verification: 41 passed (pytest) + 45 passed (node --test); git diff
--check clean; natural-language semantics remain not-machine-proven.
@github-actions

Copy link
Copy Markdown

Welcome! Thanks for your first pull request in this repository.

A maintainer will review it soon. Please make sure:

  • Your changes are tested
  • Documentation is updated if needed
  • The PR description explains what and why

Thanks for contributing!

@lukisch
lukisch merged commit 3476ba2 into master Jul 31, 2026
8 checks passed
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