Skip to content

TR mirror drift in docs/guides/iso_soc2_deployer_guide.md: on classifier crash audit.classifier_load_failed fires, pipeline.failed propagates and run does NOT produce final_model/ (DOC-TR08-010) #324

Open

Description

@cemililik

Wave 1 · theme D1-10: Documentation-only fixes · highest severity High · 1 finding(s) · effort docs fix

Summary

Neither: the model is saved to final_model/ (or staging) before the safety gate runs (trainer.py L1606-1613); a crash leaves artefacts on disk unless auto_revert removes them.

Primary finding

DOC-TR08-010 — TR mirror drift in docs/guides/iso_soc2_deployer_guide.md: on classifier crash audit.classifier_load_failed fires, pipeline.failed propagates and run does NOT produce final_model/

severity High

Where. EN docs/guides/iso_soc2_deployer_guide.md:245-253 · TR docs/guides/iso_soc2_deployer_guide-tr.md:246-257

English text. on classifier crash audit.classifier_load_failed fires, pipeline.failed propagates and run does NOT produce final_model/

Turkish text. koşum final_model/ dizini ÜRETMEZ

Which is correct. Neither: the model is saved to final_model/ (or staging) before the safety gate runs (trainer.py L1606-1613); a crash leaves artefacts on disk unless auto_revert removes them.

Proposed correction (Turkish text for the -tr page). Sınıflandırıcı çökerse audit.classifier_load_failed yayılır ve koşum hata ile biter; ancak model güvenlik kapısından ÖNCE kaydedildiği için diskte final_model/ (veya staging) kalabilir. Bu dizini dağıtıma almadan önce koşumun exit kodunu ve pipeline.failed event'ini denetleyin; auto_revert açıksa model silinir.

Acceptance criteria

  • Each statement is re-checked against the code at fix time.
  • Documentation listed above is corrected in English and in its Turkish mirror in the same PR.
  • Every finding in this issue is resolved or explicitly closed with a reason.

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

No one assigned

    Labels

    documentationImprovements or additions to documentationi18nEnglish/Turkish documentation mirrorseverity: highWrong behaviour or a false claim users rely onsource: review-2026-10Found by the October 2026 code and documentation reviewwave: 1Roadmap wave 1: high severity, small effort

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions