Skip to content

docs(i18n): translate brain docs to English (#14) - #87

Merged
eSlider merged 1 commit into
mainfrom
docs/i18n-brain-14
Nov 11, 2026
Merged

eSlider merged 1 commit into
mainfrom
docs/i18n-brain-14

Conversation

@eSlider

@eSlider eSlider commented Nov 11, 2026

Copy link
Copy Markdown
Owner

What

Translates the remaining Russian docs of the brain group to English (Gitea issue: https://git.pro-dukt.de/edelweiss/2dph/issues/14, part of issue #14 "translate remaining Russian docs").

Files (10)

  • docs/brain/contract.md
  • docs/brain/crm-network-filter.md
  • docs/brain/graph-gator-mail.md
  • docs/brain/graph-git-commits.md
  • docs/brain/graph-network.md
  • docs/brain/memory-adr.md
  • docs/brain/oo-network-import.md
  • docs/brain/read-contract.md
  • docs/brain/rebuild.md
  • docs/brain-synapse.md

Translation rules

  • All Russian prose, headings, table cells/captions, blockquotes and comments inside examples translated to technical English; meaning preserved 1:1 (no additions, deletions or content "improvements").
  • Not translated: code in fenced blocks, commands, flags, paths, env vars, function/file names, URLs, issue refs (#123), versions, product names (2dph, Ladybug, Gator, Edelweiss, CuraSoft, OnlyOffice, DATEV, …).
  • Domain terms kept as-is: leaf, edge, fact, info, evidence pointer, brain, ingest, audit, corpus, snapshot, tombstone, runbook, gate.
  • Markdown structure, tables, lists and code fences unchanged.
  • docs/brain/read-contract.md: intra-file link #клиентский-слой-p-95 updated to the new English heading slug — #client-layer-p-95; the section heading is now ## Client layer (P-9.5).
  • No other files touched (root README.md and docs/runbook.md untouched).

Checks

rg -n "[\p{Cyrillic}]" docs/brain docs/brain-synapse.md   # no matches
awk "/^```/{n++} END{print \"fences:\", n, (n%2==0?\"ok\":\"ODD\")}" docs/brain/*.md docs/brain-synapse.md
# fences: 40 ok
  • per-file fence count even (2/2/4/2/2/2/4/14/0/8);
  • relative links resolve (contract.md, read-contract.md, graph-network.md, crm-network-filter.md, oo-network-import.md, ../facts/audit-recipes.md), internal anchor matches its heading;
  • inline-code token sets identical to the previous revision except the intentionally translated placeholders (@домен→@domain, info@компания→info@company, {msgs} писем … captions), escaped-pipe table rows unchanged;
  • git diff --stat: 10 files, +1124/−1118.

Notes

Two inline-code samples carried Russian placeholder words and had to follow the "no Cyrillic" gate: firstname.lastname@домен → firstname.lastname@domain, info@компания → info@company, and the about format caption {msgs} писем / {threads} тредов … → {msgs} mails / {threads} threads …; the pc-agent ingest example payload text "наблюдение pc-agent" → "pc-agent observation". Everything else in code/commands untouched.

Not merged — review requested.

@eSlider
eSlider merged commit a7e4354 into main Nov 11, 2026
@eSlider
eSlider deleted the docs/i18n-brain-14 branch November 11, 2026 20:53
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