Skip to content

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

Open

Description

@cemililik

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

Findings

  • DOC-TR10-024 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: --dry-run: Validate configuration and check model/dataset access; no training.
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:44 · TR docs/usermanuals/tr/reference/cli.md:44
    English text. --dry-run: Validate configuration and check model/dataset access; no training.
    Turkish text. Config'i ve model/dataset erisimini dogrula; egitim yok.
    Which is correct. neither; code only validates the config schema and summarises it
    Proposed correction (Turkish text for the -tr page). --dry-run: Config'i Pydantic şemasına karşı doğrular ve eğitimin ne yapacağını özetler; model veya dataset erişimi KONTROL EDİLMEZ, model/GPU yüklenmez, eğitim yok. Çok aşamalı (pipeline:) config'lerde yalnızca stage doğrulaması ve output_dir çakışma kontrolü yapılır.

  • DOC-TR10-025 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: --output DIR - Output directory for --compliance-export (default: ./compliance/).
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:56 · TR docs/usermanuals/tr/reference/cli.md:56
    English text. --output DIR - Output directory for --compliance-export (default: ./compliance/).
    Turkish text. --compliance-export için çıktı dizini (varsayılan: ./compliance/).
    Which is correct. neither; --output has no effect, the directory is the --compliance-export argument
    Proposed correction (Turkish text for the -tr page). --output DIR satırını kaldırın veya 'şu an yok sayılır; çıktı dizini --compliance-export OUTPUT_DIR değeridir' diye düzeltin.

  • DOC-TR10-026 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: model_integrity.json (written by the compliance export at training time)
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:263 · TR docs/usermanuals/tr/reference/cli.md:263
    English text. model_integrity.json (written by the compliance export at training time)
    Turkish text. (eğitim sırasında compliance export tarafından yazılır)
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). <MODEL_DIR>/model_integrity.json dosyasını (eğitimin son aşamasında ForgeTrainer ayrı bir adım olarak yazar; forgelm export onu --no-integrity-update verilmedikçe günceller) okur. Dosya anahtarsız SHA-256 listesidir ve model dizininde durur; dizine yazabilen biri hem ağırlıkları hem manifest'i değiştirebilir.

  • DOC-TR10-027 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: table of OPENAI_API_KEY, ANTHROPIC_API_KEY, COHERE_API_KEY as env vars ForgeLM picks up
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:267-275 · TR docs/usermanuals/tr/reference/cli.md:267-275
    English text. table of OPENAI_API_KEY, ANTHROPIC_API_KEY, COHERE_API_KEY as env vars ForgeLM picks up
    Turkish text. ForgeLM credential'ları environment variable'lardan alır (tablo)
    Which is correct. neither
    Proposed correction (Turkish text for the -tr page). Tablonun altına şunu ekleyin: 'ForgeLM bu değişken adlarını kendisi okumaz; anahtarın bulunduğu env var'ı synthetic.api_key_env / evaluation.llm_judge.judge_api_key_env alanında siz adlandırırsınız. İstek OpenAI uyumlu Authorization: Bearer başlığıyla gider; Anthropic/Cohere için özel bir yerleşik istemci yoktur.'

  • DOC-TR10-028 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: export HF_TOKEN (or the legacy HUGGINGFACE_TOKEN) ... both huggingface_hub's own auto-pickup and ForgeLM's login step find it
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:279 · TR docs/usermanuals/tr/reference/cli.md:279
    English text. export HF_TOKEN (or the legacy HUGGINGFACE_TOKEN) ... both huggingface_hub's own auto-pickup and ForgeLM's login step find it
    Turkish text. hem huggingface_hub'ın kendi otomatik algılaması hem de ForgeLM'in login adımı onu bulur
    Which is correct. neither; ForgeLM's login reads HUGGINGFACE_TOKEN only
    Proposed correction (Turkish text for the -tr page). HF_TOKEN'ı yalnızca huggingface_hub otomatik algılar; ForgeLM'in kendi setup_authentication adımı auth.hf_token, sonra HUGGINGFACE_TOKEN ortam değişkenini, sonra ~/.cache/huggingface/token dosyasını okur. Her iki yolun da çalışması için HUGGINGFACE_TOKEN'ı da export edin.

  • DOC-TR10-029 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: A Ctrl+C is signal-derived 130 but is clamped to 2; 5 = Wizard cancelled (operator declined to save / non-tty refusal)
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:297,300,305-307 · TR docs/usermanuals/tr/reference/cli.md:297,300,306-308
    English text. A Ctrl+C is signal-derived 130 but is clamped to 2; 5 = Wizard cancelled (operator declined to save / non-tty refusal)
    Turkish text. Ctrl+C ... 2'ye kıstırılır; 5 = Sihirbaz iptal (operatör kaydı reddetti / non-tty reddi)
    Which is correct. neither; wizard Ctrl-C exits 5, chat-prompt Ctrl-C exits 0, other Ctrl-C exits 2
    Proposed correction (Turkish text for the -tr page). Exit 5 satırını 'Sihirbaz iptal (Ctrl-C/EOF, kaydetmeyi reddetme veya non-tty reddi)' yapın; Ctrl+C paragrafını 'sihirbaz dışındaki komutlarda Ctrl+C 2 ile çıkar (chat istemindeki Ctrl+C ise 0)' diye düzeltin.

  • DOC-TR10-030 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: 3 | Auto-revert / regression
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:298 · TR docs/usermanuals/tr/reference/cli.md:298
    English text. 3 | Auto-revert / regression
    Turkish text. 3 | Auto-revert / regression
    Which is correct. neither; also audit gate and safety-eval gate
    Proposed correction (Turkish text for the -tr page). 3 | Kalite/güvenlik kapısı başarısız: auto_revert: true ile otomatik geri alma (artefaktlar silinir), forgelm audit secret/kritik-PII kapısı, forgelm safety-eval kapısı.

  • DOC-TR10-031 (TR mirror, Medium) — TR mirror drift in docs/usermanuals/en/reference/cli.md: National IDs, emails and phone numbers are matched on shape and deliberately over-report
    severity Medium
    Where. EN docs/usermanuals/en/reference/cli.md:352 · TR docs/usermanuals/tr/reference/cli.md:353
    English text. National IDs, emails and phone numbers are matched on shape and deliberately over-report
    Turkish text. Ulusal kimlikler, e-postalar ve telefon numaraları şekil üzerinden eşleşir ve kasıtlı olarak fazla raporlar
    Which is correct. neither; tr_id (TC Kimlik No) passes a checksum, us_ssn/fr_ssn/de_id, email, phone are shape-only
    Proposed correction (Turkish text for the -tr page). us_ssn, fr_ssn, de_id, e-posta ve telefon yalnızca şekil üzerinden eşleşir ve kasıtlı olarak fazla raporlar; tr_id (TC Kimlik No) ise checksum ile doğrulanır ama yine de high katmandadır ve exit kodunu belirlemez.

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