Skip to content

[Wave 3] Medium — TR mirror: docs/usermanuals/en/reference/configuration.md #632

Open

Description

@cemililik

Wave 3 · 5 finding(s) in 5 fix package(s). English/Turkish mirror drift for this document pair; fix the side the finding names.

Findings

  • DOC-TR10-032 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/configuration.md: shuffle: true # shuffle the merged corpus before splitting train/validation
    severity Medium
    Where. EN docs/usermanuals/en/reference/configuration.md:78 · TR docs/usermanuals/tr/reference/configuration.md:78
    English text. shuffle: true # shuffle the merged corpus before splitting train/validation
    Turkish text. train/validation ayrımından önce birleşik korpusu karıştır
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). shuffle: true # ayrımdan SONRA yalnızca train split'ini karıştır (seed 42); validation sırası korunur

  • DOC-TR10-033 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/configuration.md: Format is auto-detected per file; supported shapes are instructions, messages, preference, binary, reward
    severity Medium
    Where. EN docs/usermanuals/en/reference/configuration.md:89 · TR docs/usermanuals/tr/reference/configuration.md:89
    English text. Format is auto-detected per file; supported shapes are instructions, messages, preference, binary, reward
    Turkish text. Format dosya başına otomatik algılanır; desteklenen şekiller instructions, messages, preference, binary, reward
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). Format, dataset sütun adlarından tek seferde algılanır: chosen+rejected (tercih/DPO), completion+label (KTO), messages, yalnızca prompt (GRPO), User|instruction + Assistant|output|response, veya text. 'reward' diye bir şekil yoktur.

  • DOC-TR10-034 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/configuration.md: max_acceptable_loss ... hard cap on validation loss; requires auto_revert: true
    severity Medium
    Where. EN docs/usermanuals/en/reference/configuration.md:136 · TR docs/usermanuals/tr/reference/configuration.md:137
    English text. max_acceptable_loss ... hard cap on validation loss; requires auto_revert: true
    Turkish text. validation loss'a sert tavan; auto_revert: true gerektirir
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). # float — validation loss tavanı; aşılırsa audit olayı yazılır, ancak model yalnızca auto_revert: true iken SİLİNİR (false iken sadece uyarı, model kalır)

  • DOC-TR10-035 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/configuration.md: The append-only audit log always writes to <training.output_dir>/audit_log.jsonl
    severity Medium
    Where. EN docs/usermanuals/en/reference/configuration.md:249 · TR docs/usermanuals/tr/reference/configuration.md:250
    English text. The append-only audit log always writes to <training.output_dir>/audit_log.jsonl
    Turkish text. Append-only audit log her zaman <training.output_dir>/audit_log.jsonl'a yazar
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). Tek aşamalı koşuda <training.output_dir>/audit_log.jsonl; çok aşamalı pipeline: koşusunda pipeline kök dizininde (pipeline.output_dir) ayrı bir pipeline log'u ve her stage'in kendi output_dir'inde stage log'u; purge, reverse-pii, approve/reject, safety-eval, cache-* ise kendi --output-dir/--audit-dir dizinlerine yazar.

  • DOC-TR10-036 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/configuration.md: endpoint_env: env var overriding endpoint; *_env fields are read directly via os.environ
    severity Medium
    Where. EN docs/usermanuals/en/reference/configuration.md:283,193 · TR docs/usermanuals/tr/reference/configuration.md:284,194
    English text. endpoint_env: env var overriding endpoint; *_env fields are read directly via os.environ
    Turkish text. endpoint'i geçersiz kılan env değişkeni; *_env alanları doğrudan os.environ ile okunan ...
    Which is correct. neither for monitoring
    Proposed correction (Turkish text for the -tr page). monitoring.endpoint_env hiçbir yerde okunmaz (set edilmiş endpoint zaten önceliklidir); *_env cümlesini 'webhook, synthetic ve judge alanları için' diye daraltın.

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationi18nEnglish/Turkish documentation mirrorseverity: mediumReal defect with limited reach or a workaroundsource: review-2026-10Found by the October 2026 code and documentation reviewwave: 3Roadmap wave 3: medium severity, module sweeps

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions