Skip to content

[Wave 3] Medium — TR mirror: docs/usermanuals/en/reference/exit-codes.md #633

Open

Description

@cemililik

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

Findings

  • DOC-TR10-037 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/exit-codes.md: NaN loss is a training-time runtime error -> 2
    severity Medium
    Where. EN docs/usermanuals/en/reference/exit-codes.md:16,87 · TR docs/usermanuals/tr/reference/exit-codes.md:16,87
    English text. NaN loss is a training-time runtime error -> 2
    Turkish text. NaN loss ... 2
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). NaN/Inf eval_loss: auto_revert: true ise model silinir ve exit 3; false ise yalnızca uyarı loglanır, model terfi eder ve exit 0 olur. Exit 2 yalnızca OOM / I/O / yakalanmamış istisnadır.

  • DOC-TR10-038 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/exit-codes.md: Any other non-zero value (including signal-derived 128+N) is clamped to 2 before the process exits
    severity Medium
    Where. EN docs/usermanuals/en/reference/exit-codes.md:22 · TR docs/usermanuals/tr/reference/exit-codes.md:22
    English text. Any other non-zero value (including signal-derived 128+N) is clamped to 2 before the process exits
    Turkish text. Diğer her sıfır olmayan değer ... 2 değerine sıkıştırılır
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). 'Dispatcher'ın döndürdüğü (verify-audit, pipeline) public olmayan kodlar ve yakalanan Ctrl+C (KeyboardInterrupt) 2'ye sıkıştırılır; işletim sisteminin dışarıdan gönderdiği sinyallerle (SIGTERM/SIGKILL) sonlandırılan süreç 128+N koduyla çıkabilir.'

  • DOC-TR10-039 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/exit-codes.md: continue-on-error + steps.train.outputs.exit-code
    severity Medium
    Where. EN docs/usermanuals/en/reference/exit-codes.md:30-43,99 · TR docs/usermanuals/tr/reference/exit-codes.md:30-43,99
    English text. continue-on-error + steps.train.outputs.exit-code
    Turkish text. aynı
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). Bkz. ilk öneri: çıkış kodunu açıkça $GITHUB_OUTPUT'a yazın.

  • DOC-TR10-040 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/exit-codes.md: if: steps.train.outcome == 'failure' && steps.train.conclusion == 'failure'
    severity Medium
    Where. EN docs/usermanuals/en/reference/exit-codes.md:36-43 · TR docs/usermanuals/tr/reference/exit-codes.md:36-43
    English text. if: steps.train.outcome == 'failure' && steps.train.conclusion == 'failure'
    Turkish text. if: steps.train.outcome == 'failure'
    Which is correct. TR condition is the working one (with continue-on-error the conclusion is 'success'); both still use a non-existent exit-code output
    Proposed correction (Turkish text for the -tr page). TR için çalışan örnek: - name: Train / id: train / run: | + set +e + forgelm --config configs/run.yaml + echo "exit-code=$?" >> "$GITHUB_OUTPUT" + exit 0; sonraki adımda if: steps.train.outputs.exit-code == '3' ile dallanın. (steps.<id>.outputs.exit-code kendiliğinden oluşmaz.)

  • DOC-TR10-041 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/exit-codes.md: ${HF_TOKEN} set in YAML but env var missing -> 1
    severity Medium
    Where. EN docs/usermanuals/en/reference/exit-codes.md:85 · TR docs/usermanuals/tr/reference/exit-codes.md:85
    English text. ${HF_TOKEN} set in YAML but env var missing -> 1
    Turkish text. YAML'da ${HF_TOKEN} ama env var yok -> 1
    Which is correct. neither; no interpolation exists
    Proposed correction (Turkish text for the -tr page). Satırı kaldırın veya şöyle yazın: 'YAML'da ${HF_TOKEN} yazmak işe yaramaz (interpolasyon yok): metin birebir token sayılır, Hugging Face girişi başarısız olur (yalnızca WARNING) ve gated model yüklemesi ilerleyen adımda hata verir.'

  • DOC-TR10-042 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/exit-codes.md: forgelm verify-* - path missing, unreadable, or malformed input -> 1
    severity Medium · already tracked: KNOWN-OPEN C31-EXIT-CODE-PROSE docs/roadmap/phase-16-trust-surface-hardening.md:782-784
    Where. EN docs/usermanuals/en/reference/exit-codes.md:91,24 · TR docs/usermanuals/tr/reference/exit-codes.md:91,24
    English text. forgelm verify-* - path missing, unreadable, or malformed input -> 1
    Turkish text. yol eksik, okunamıyor veya girdi bozuk -> 1
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). 'yol eksik, normal dosya değil veya girdi bozuk (karşılaştırılacak bir şey yok) -> 1; var olan bir yolda okuma/izin hatası -> 2 (yeniden denenebilir)'; 1 tarafındaki bilinçli durumlar yalnızca ikiyle sınırlı değildir (bozuk sidecar, sidecar eşleşen dosyada metadata-parse hatası, 'unattested' pipeline korroborasyonu).

  • DOC-TR10-043 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/exit-codes.md: richer postmortem context (regressed categories, restored checkpoint path, etc.), parse the audit_log.jsonl event
    severity Medium · already tracked: KNOWN-OPEN DOCS-04 docs/roadmap/phase-16-trust-surface-hardening.md:760-765
    Where. EN docs/usermanuals/en/reference/exit-codes.md:99 · TR docs/usermanuals/tr/reference/exit-codes.md:99
    English text. richer postmortem context (regressed categories, restored checkpoint path, etc.), parse the audit_log.jsonl event
    Turkish text. regrese kategoriler, restore edilmiş checkpoint yolu vb.
    Which is correct. neither; nothing is restored
    Proposed correction (Turkish text for the -tr page). '(regrese kategoriler, revert gerekçesi vb.)' yazın; 'restore edilmiş checkpoint yolu' ifadesini kaldırın — auto-revert artefaktları siler.

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.

Activity

  1. added
    documentationImprovements or additions to documentation
    backlog: knownAlready tracked in docs/roadmap
    i18nEnglish/Turkish documentation mirror
    severity: mediumReal defect with limited reach or a workaround
    source: review-2026-10Found by the October 2026 code and documentation review
    wave: 3Roadmap wave 3: medium severity, module sweeps
    on Oct 9, 2026
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

    backlog: knownAlready tracked in docs/roadmapdocumentationImprovements 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