[Wave 4] Low/info — TR mirror: docs/reference/ (part 1/2) #808

Wave 4 · 20 finding(s) in 20 fix package(s). Mirror drift across small document pairs in this directory.

Findings

• DOC-TR01-004 (TR mirror, Low) — TR mirror drift in docs/reference/architecture.md: └── CONTRIBUTING.md
  severity Low
  Where. EN docs/reference/architecture.md:107 · TR docs/reference/architecture-tr.md:106
  English text. └── CONTRIBUTING.md
  Turkish text. (line absent)
  Which is correct. EN.
  Proposed correction (Turkish text for the -tr page). Ekle: '└── CONTRIBUTING.md # Katkıda bulunan rehberi'.

• DOC-TR01-005 (TR mirror, Low) — TR mirror drift in docs/reference/architecture.md: Runs a configurable safety classifier (Llama Guard, ShieldGemma)... triggers auto-revert... Errors are treated as unsafe (fail-safe principle).
  severity Low
  Where. EN docs/reference/architecture.md:134 · TR docs/reference/architecture-tr.md:133
  English text. Runs a configurable safety classifier (Llama Guard, ShieldGemma)... triggers auto-revert... Errors are treated as unsafe (fail-safe principle).
  Turkish text. İki puanlama modu: binary ve confidence-weighted. 3 katmanlı güvenlik kapısı... S1-S14... safety_trend.jsonl.
  Which is correct. TR is closer to code (modes config.py:946, three gates safety/_gates.py:208, trend safety/_results.py:158); EN's ShieldGemma is false. TR omits auto-revert and fail-closed semantics.
  Proposed correction (Turkish text for the -tr page). TR sonuna ekle: 'Güvenlik kapısı aşılırsa (auto_revert açıksa) model silinir; sınıflandırıcıdan okunabilir verdict alınamayan çiftler fail-closed olarak güvensiz sayılır.' EN: remove ShieldGemma.

• DOC-TR01-006 (TR mirror, Low) — TR mirror drift in docs/reference/architecture.md: export_compliance_artifacts(): All artifacts to directory
  severity Low
  Where. EN docs/reference/architecture.md:146 · TR docs/reference/architecture-tr.md:138-145
  English text. export_compliance_artifacts(): All artifacts to directory
  Turkish text. (bullet missing)
  Which is correct. EN; function exists at compliance.py:2137.
  Proposed correction (Turkish text for the -tr page). Ekle: '- export_compliance_artifacts(): Tüm artefaktları dizine yazar'.

• DOC-TR01-007 (TR mirror, Low) — TR mirror drift in docs/reference/architecture.md: Supports URL from config or environment variable.
  severity Low
  Where. EN docs/reference/architecture.md:172 · TR docs/reference/architecture-tr.md:170
  English text. Supports URL from config or environment variable.
  Turkish text. (env-var URL support not mentioned)
  Which is correct. EN (webhook.url_env exists in config).
  Proposed correction (Turkish text for the -tr page). Ekle: 'URL config veya ortam değişkeninden (url_env) alınır.'

• DOC-TR01-008 (TR mirror, Low) — TR mirror drift in docs/reference/configuration.md: comma-separated expert indices (e.g., "0,1,2")
  severity Low
  Where. EN docs/reference/configuration.md:29 · TR docs/reference/configuration-tr.md:29
  English text. comma-separated expert indices (e.g., "0,1,2")
  Turkish text. virgülle ayrılmış indeksler
  Which is correct. EN (config.py:125 accepts the comma-separated string).
  Proposed correction (Turkish text for the -tr page). '"all" veya virgülle ayrılmış expert indeksleri (ör. "0,1,2")'.

• DOC-TR01-009 (TR mirror, Low) — TR mirror drift in docs/reference/configuration.md: Each retry attempt is logged to the audit trail.
  severity Low
  Where. EN docs/reference/configuration.md:107-108 · TR docs/reference/configuration-tr.md:106
  English text. Each retry attempt is logged to the audit trail.
  Turkish text. (sentence missing)
  Which is correct. EN (audit event training.oom_recovery, trainer.py:1244).
  Proposed correction (Turkish text for the -tr page). Ekle: 'Her yeniden deneme audit izine training.oom_recovery olayı olarak yazılır.'

• DOC-TR01-010 (TR mirror, Low) — TR mirror drift in docs/reference/configuration.md: Weighted score threshold (0.0-1.0)...; severity_thresholds example includes medium
  severity Low
  Where. EN docs/reference/configuration.md:214,217 · TR docs/reference/configuration-tr.md:213,216
  English text. Weighted score threshold (0.0-1.0)...; severity_thresholds example includes medium
  Turkish text. Ağırlıklı skor eşiği (confidence_weighted için); örnek yalnızca critical/high
  Which is correct. EN for the range (config.py:956-960 ge=0 le=1).
  Proposed correction (Turkish text for the -tr page). 'Ağırlıklı skor eşiği (0.0-1.0); scoring="confidence_weighted" iken kullanılır' ve örneğe "medium": 0.05 ekle.

• DOC-TR01-011 (TR mirror, Low) — TR mirror drift in docs/reference/configuration.md: See compliance_summary.md#... for the field-by-field meaning of every resolution_source and hf_revision_source value.
  severity Low
  Where. EN docs/reference/configuration.md:618-620 · TR docs/reference/configuration-tr.md:612-614
  English text. See compliance_summary.md#... for the field-by-field meaning of every resolution_source and hf_revision_source value.
  Turkish text. resolution_source sentence is duplicated ('...her resolution_source değerinin ... — her resolution_source ve hf_revision_source değeri için')
  Which is correct. EN (single sentence).
  Proposed correction (Turkish text for the -tr page). Tek cümleye indir: 'Her resolution_source ve hf_revision_source değerinin alan-alan anlamı için bkz. compliance_summary-tr.md#annex-iv-paketi-provenance-alanları'.

• DOC-TR01-012 (TR mirror, Low) — TR mirror drift in docs/reference/data_preparation.md: thousands of datasets on the HF Hub
  severity Low
  Where. EN docs/reference/data_preparation.md:17 · TR docs/reference/data_preparation-tr.md:18
  English text. thousands of datasets on the HF Hub
  Turkish text. yüz binlerce veri setine
  Which is correct. Not checkable offline; the two numbers disagree.
  Proposed correction. 'binlerce veri setine'.

• DOC-TR01-013 (TR mirror, Low) — TR mirror drift in docs/reference/usage.md: PII flag counts with severity tiers
  severity Low
  Where. EN docs/reference/usage.md:243 · TR docs/reference/usage-tr.md:228
  English text. PII flag counts with severity tiers
  Turkish text. ... pii_severity bloğu her PII tipini critical/high/medium/low puanlar ve worst_tier verdict yüzdürür
  Which is correct. TR is accurate (data_audit/_summary.py:24-60).
  Proposed correction. No TR change; EN may adopt the detail.

• DOC-TR01-014 (TR mirror, Low) — TR mirror drift in docs/reference/usage.md: Model below threshold - adjust data or thresholds
  severity Low
  Where. EN docs/reference/usage.md:267 · TR docs/reference/usage-tr.md:247
  English text. Model below threshold - adjust data or thresholds
  Turkish text. Model eşiğin altında
  Which is correct. EN has the CI action text; both omit the audit exit 3 cause.
  Proposed correction (Turkish text for the -tr page). 'Model eşiğin altında veya audit kapısı (kritik secrets/PII) - veriyi ya da eşikleri düzeltin'.

• DOC-TR01-015 (TR mirror, Low) — TR mirror drift in docs/reference/usage.md: safety/ # Safety results (if enabled)
  severity Low
  Where. EN docs/reference/usage.md:293-294 · TR docs/reference/usage-tr.md:271-273
  English text. safety/ # Safety results (if enabled)
  Turkish text. safety/ → safety_results.json, safety_trend.jsonl
  Which is correct. TR is more complete (safety/_results.py:106,158); EN should list both.
  Proposed correction. Fix on the EN side; keep TR, adding '(etkinse)'.

• DOC-TR02-001 (TR mirror, Low) — TR mirror drift in docs/reference/compliance_summary.md: ForgeLM ships technical evidence for ~59 of the 93 ISO 27001 Annex A controls (11 marked FL "full" + 48 FL-helps "partial" in docs/refere… severity **Low** **Where.** EN [docs/reference/compliance_summary.md:278-281](https://github.com/HodeTech/ForgeLM/blob/cab2947/docs/reference/compliance_summary.md#L278-L281) · TR [docs/reference/compliance_summary-tr.md:279-281](https://github.com/HodeTech/ForgeLM/blob/cab2947/docs/reference/compliance_summary-tr.md#L279-L281) **English text.** ForgeLM ships technical evidence for ~59 of the 93 ISO 27001 Annex A controls (11 marked FL"full" + 48FL-helps"partial" indocs/reference/iso27001_control_mapping.md); the remaining ~34 are OOS deployer-side **Turkish text.** ForgeLM, 93 ISO 27001 Annex A kontrolünün ~59'una teknik kanıt sağlar (FL11 +FL-helps48; bkz. ISO control mapping doğrulu sayım); kalan ~34 deployer-tarafı **Which is correct.** Sayılar (11/48/34, toplam 93) iki tarafta da kod/tablo ile uyumlu (iso27001_control_mapping.md ve -tr.md satır sayımı: FL 11, FL-helps 48, OOS 34). EN daha eksiksiz:FL/FL-helps/OOSanlamlarını ve dosya yolunu veriyor. TR'de yol veOOS etiketi düşmüş, 'doğrulu sayım' ifadesi anlaşılmaz. **Proposed correction (Turkish text for the -tr page).** ForgeLM, 93 ISO 27001 Annex A kontrolünün ~59'una teknik kanıt sağlar (docs/reference/iso27001_control_mapping-tr.mdiçinde 11 kontrolFL"tam", 48 kontrolFL-helps"kısmi" işaretlidir); kalan ~34 kontrolOOS`, yani deployer tarafındadır (fiziksel güvenlik, HR süreçleri, ağ ayrıştırması vb.).

• DOC-TR03-001 (TR mirror, Low) — TR mirror drift in docs/reference/data_ingestion_architecture.md: Single entry point: ingest_path (currently at line 2193).
  severity Low
  Where. EN docs/reference/data_ingestion_architecture.md:38 · TR docs/reference/data_ingestion_architecture-tr.md:38-39
  English text. Single entry point: ingest_path (currently at line 2193).
  Turkish text. Tek giriş noktası: ingest_path, satır 1200.
  Which is correct. Neither; ingest_path is defined at forgelm/ingestion.py:2218. TR value is ~1000 lines off, EN ~25 lines off.
  Proposed correction (Turkish text for the -tr page). Satır numarasını kaldırın: 'Tek giriş noktası: forgelm.ingestion.ingest_path. CLI alt komutu ... ince bir argparse adaptörüdür.' (EN'de de aynı kaldırma yapılmalı; check_source_path_refs satır numarası denetlemez.)

• DOC-TR03-002 (TR mirror, Low) — TR mirror drift in docs/reference/data_ingestion_architecture.md: encoded as a docstring comment in ingestion.py:2078
  severity Low
  Where. EN docs/reference/data_ingestion_architecture.md:443 · TR docs/reference/data_ingestion_architecture-tr.md:442
  English text. encoded as a docstring comment in ingestion.py:2078
  Turkish text. ingestion.py:1098'da docstring yorumu olarak kodlanmıştır
  Which is correct. Neither; the rationale is in the _emit_chunk docstring at ingestion.py:2113-2121 (def at :2103).
  Proposed correction (Turkish text for the -tr page). '(ingestion.py::_emit_chunk docstring yorumu olarak kodlanmıştır)' — satır numarası yerine sembol kullanın.

• DOC-TR03-003 (TR mirror, Low) — TR mirror drift in docs/reference/doctor_subcommand.md: pass if FORGELM_OPERATOR set, warn if getpass fallback, fail if neither (unless FORGELM_ALLOW_ANONYMOUS_OPERATOR=1)
  severity Low
  Where. EN docs/reference/doctor_subcommand.md:38 · TR docs/reference/doctor_subcommand-tr.md:38
  English text. pass if FORGELM_OPERATOR set, warn if getpass fallback, fail if neither (unless FORGELM_ALLOW_ANONYMOUS_OPERATOR=1)
  Turkish text. ... ikisi de yoksa fail (FORGELM_ALLOW_ANONYMOUS_OPERATOR=1 ise warn)
  Which is correct. TR (explicit warn with opt-in) matches _doctor.py:896-912; EN leaves the resulting status implicit.
  Proposed correction (Turkish text for the -tr page). TR değişmez. EN'e 'warn with FORGELM_ALLOW_ANONYMOUS_OPERATOR=1' eklenmeli.

• DOC-TR03-004 (TR mirror, Low) — TR mirror drift in docs/reference/doctor_subcommand.md: docs/usermanuals/en/reference/json-output.md
  severity Low
  Where. EN docs/reference/doctor_subcommand.md:77 · TR docs/reference/doctor_subcommand-tr.md:77
  English text. docs/usermanuals/en/reference/json-output.md
  Turkish text. docs/usermanuals/en/reference/json-output.md'de kilitli
  Which is correct. EN link is right for EN; TR points to the English page although TR:136 links the tr mirror.
  Proposed correction (Turkish text for the -tr page). TR:77: docs/usermanuals/tr/reference/json-output.md (../usermanuals/tr/reference/json-output.md) bağlantısını kullanın.

• DOC-TR03-005 (TR mirror, Low) — TR mirror drift in docs/reference/safety_eval_subcommand.md: (unsafe_ratio > ceiling)
  severity Low
  Where. EN docs/reference/safety_eval_subcommand.md:46 · TR docs/reference/safety_eval_subcommand-tr.md:46
  English text. (unsafe_ratio > ceiling)
  Turkish text. (unsafe_ratio > tavan)
  Which is correct. Code-span text should be identifier-like; the code (_gates.py:259) uses (1.0 - safe_ratio) > max_safety_regression, so neither is literal.
  Proposed correction (Turkish text for the -tr page). unsafe_ratio > max_safety_regression yazın (kod span'ında Türkçe sözcük kullanmayın).

• DOC-TR03-006 (TR mirror, Low) — TR mirror drift in docs/reference/safety_eval_subcommand.md: broken core dependency import (transformers, forgelm.safety)
  severity Low
  Where. EN docs/reference/safety_eval_subcommand.md:77 · TR docs/reference/safety_eval_subcommand-tr.md:77
  English text. broken core dependency import (transformers, forgelm.safety)
  Turkish text. bozuk core bağımlılık import'u
  Which is correct. EN is more specific; TR omits the named modules (no behavioural difference).
  Proposed correction (Turkish text for the -tr page). 'bozuk core bağımlılık import'u (transformers, forgelm.safety)'

• DOC-TR04-035 (TR mirror, Low) — TR mirror drift in docs/reference/iso27001_control_mapping.md: A.5.13 Labelling: model_card.md
  severity Low
  Where. EN docs/reference/iso27001_control_mapping.md:37 · TR docs/reference/iso27001_control_mapping-tr.md:36
  English text. A.5.13 Labelling: model_card.md
  Turkish text. A.5.13 Bilgi etiketleme: model_card.md; manifest'te risk class
  Which is correct. Neither. The model card is the README.md written to the model directory (model_card.py:342).
  Proposed correction. 'Model dizinindeki README.md (model card); manifest'te risk class'

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.}