Repository navigation
[Wave 4] Low/info — TR mirror: docs/guides/data_audit.md #81
Description
Wave 4 · 6 finding(s) in 6 fix package(s). English/Turkish mirror drift for this document pair; fix the side the finding names.
Findings
-
DOC-TR07-001 (TR mirror, Low) — TR mirror drift in docs/guides/data_audit.md: Section order differs from the English guide.
severity Low
Where. ENdocs/guides/data_audit.md:234-241(pattern precedence after PII gate) and :594-606 (--workers after flag prose) · TRdocs/guides/data_audit-tr.md:132-139(pattern precedence under PII summary) and :578-590 (--workers before flag prose)
English text. Section order differs from the English guide.
Turkish text. Section order differs; content equal.
Which is correct. EN order is canonical; no substantive content difference.
Proposed correction (Turkish text for the -tr page). Reorder TR to match EN per docs/standards/localization.md structural mirror rule (move 'Pattern önceliği' paragraph after the PII gate section; move --workers paragraphs after the flag description paragraph). -
DOC-TR07-002 (TR mirror, Low) — TR mirror drift in docs/guides/data_audit.md: Measured ~1.3x raw per-digest / ~1.05x end-to-end; the '4-10x' figure xxhash advertises refers to C-level benchmarks; the optional dep is mostly forward-…
severity Low
Where. ENdocs/guides/data_audit.md:263-271· TRdocs/guides/data_audit-tr.md:267-272
English text. Measured ~1.3x raw per-digest / ~1.05x end-to-end; the '4-10x' figure xxhash advertises refers to C-level benchmarks; the optional dep is mostly forward-compat, not a throughput win.
Turkish text. ~1.3x ham digest başına, ~1.05x end-to-end ... backend swap'i öncelikle ileriye dönük güvence (the 4-10x remark and the 'real wall-clock gain comes from lru_cache' sentence are omitted).
Which is correct. Numbers 1.3x / 1.05x / lru_cache(maxsize=10_000) match code (_simhash.py:55); omission only, no contradiction.
Proposed correction (Turkish text for the -tr page). İsteğe bağlı: 'xxhash'in duyurulan 4-10x hızı C seviyesindeki ham hash benchmark'ına aittir; Python sarmalayıcısıyla bu fark kapanır. Gerçek duvar-saati kazancı çoğunlukla lru_cache'ten gelir.' -
DOC-TR07-003 (TR mirror, Low) — TR mirror drift in docs/guides/data_audit.md: JSON Web Tokens (anchored on the eyJ-encoded JSON header)
severity Low
Where. ENdocs/guides/data_audit.md:329-335· TRdocs/guides/data_audit-tr.md:330-339
English text. JSON Web Tokens (anchored on the eyJ-encoded JSON header)
Turkish text. JSON Web Token'lar (eyJ ile encode edilmiş JSON başlığına anchored — sadece alg/typ/kid gibi kanonik header anahtarlarına bağlı, böylece prosa false-positive üretmiyor)
Which is correct. TR (verified: _secrets.py jwt pattern anchors eyJ(hbGc|0eXA|raWQ|jdHk|lbmM|hcGk), i.e. alg/typ/kid/cty/enc/api).
Proposed correction. TR-only claim is accurate; recommend adding to EN. Optionally list all six anchors: alg, typ, kid, cty, enc, api. -
DOC-TR07-004 (TR mirror, Low) — TR mirror drift in docs/guides/data_audit.md: repeated_lines ... Catches boilerplate (headers, footers, repeated disclaimers) that bloats training without adding signal.
severity Low
Where. ENdocs/guides/data_audit.md:384-386· TRdocs/guides/data_audit-tr.md:389-392
English text. repeated_lines ... Catches boilerplate (headers, footers, repeated disclaimers) that bloats training without adding signal.
Turkish text. ... Boilerplate'i yakalar — kısa, tamamen tekil belgelerde false positive üretmemek için sayım filtresi şart (count >= 2).
Which is correct. TR claim verified; both consistent with code.
Proposed correction. No TR change; TR-only rationale is correct (docstring of _check_repeated_lines, _quality.py:~170). -
DOC-TR07-005 (TR mirror, Low) — TR mirror drift in docs/guides/data_audit.md: Markdown fenced code blocks (
and ~~~) are stripped ... Pure-code rows surface zero flags. severity **Low** **Where.** EN [`docs/guides/data_audit.md:388-393`](https://github.com/HodeTech/ForgeLM/blob/cab2947/docs/guides/data_audit.md#L388-L393) · TR [`docs/guides/data_audit-tr.md:394-398`](https://github.com/HodeTech/ForgeLM/blob/cab2947/docs/guides/data_audit-tr.md#L394-L398) **English text.** Markdown fenced code blocks (and ~~~) are stripped ... Pure-code rows surface zero flags.
Turkish text. Heuristikler markdown fenced kod bloklarını otomatik atlar ... Kod yoğun bir satırın tamamı stripping sonrası boş kalırsa hiçbir flag atılmaz.
Which is correct. Code (_quality.py:_strip_code_fences, _row_quality_flags) strips bothand ~~~ and returns [] per ROW; TR omits ~~~ and says 'satır' (line) where 'row' is meant. **Proposed correction (Turkish text for the -tr page).** Markdown fenced kod blokları (ve ~~~) bu heuristikler uygulanmadan önce çıkarılır; fence'ler çıkarıldıktan sonra satır (row) boş kalıyorsa (saf kod) hiçbir flag atılmaz. -
DOC-TR07-006 (TR mirror, Low) — TR mirror drift in docs/guides/data_audit.md: Note: ... The full data_audit_report.json is always written to --output via tempfile.NamedTemporaryFile + os.replace — Phase 11.5 hardening so a crashed…
severity Low
Where. ENdocs/guides/data_audit.md:587-592· TRdocs/guides/data_audit-tr.md:612-616
English text. Note: ... The full data_audit_report.json is always written to --output via tempfile.NamedTemporaryFile + os.replace — Phase 11.5 hardening so a crashed audit can never leave a half-written report on disk.
Turkish text. Not: ... Tam data_audit_report.json her zaman --output altına yazılır. Her detayı istiyorsanız diskten okuyun.
Which is correct. EN (verified: _atomic_write_json in forgelm/data_audit/_orchestrator.py:141-171 uses NamedTemporaryFile + os.replace + fsync). TR drops a reliability statement; the TR intro (lines 8-9) still mentions 'atomik disk yazımı'.
Proposed correction (Turkish text for the -tr page). Not: Tam data_audit_report.json her zaman --output altına, geçici dosya (tempfile.NamedTemporaryFile) + os.replace ile atomik olarak yazılır; çöken bir audit diskte yarım rapor bırakmaz.
Done when
- Every finding above is fixed or closed with a reason (tick it here).
- Code fixes carry a test; doc fixes update the Turkish mirror in the same PR.
Found by the October 2026 ForgeLM code and documentation review against commit cab2947. Code links point at that commit; line numbers may have moved since. Finding IDs (CR-…, DOC-…, TECH-…) are stable references for this backlog.
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fieldsTodo
Activity