Skip to content

[Wave 4] Low/info — TR mirror: docs/guides/ #805

Open

Description

@cemililik

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

Findings

  • DOC-TR06-031 (TR mirror, Low) — TR mirror drift in docs/guides/alignment.md: The format component returns 1.0 when the generation ends with Answer: <value>
    severity Low
    Where. EN docs/guides/alignment.md:181 · TR docs/guides/alignment-tr.md:198-200
    English text. The format component returns 1.0 when the generation ends with Answer: <value>
    Turkish text. Format bileşeni, üretim Answer: <değer> ile bittiğinde 1.0 döner
    Which is correct. Neither is exact. Both are wrong the same way: the gate passes whenever the rstripped completion's last line contains 'Answer: ', so trailing prose after the value still scores 1.0.
    Proposed correction (Turkish text for the -tr page). Format bileşeni, (sondaki boşluklar kırpıldıktan sonra) tamamlamanın SON satırında Answer: <değer> kalıbı geçiyorsa 1.0 döner (büyük/küçük harf duyarsız; değerden sonra birim veya ek metin olabilir).

  • DOC-TR06-032 (TR mirror, Low) — TR mirror drift in docs/guides/alignment.md: # Step 4 asks: "Choose your training objective"
    severity Low
    Where. EN docs/guides/alignment.md:210-214 · TR docs/guides/alignment-tr.md:249-253
    English text. # Step 4 asks: "Choose your training objective"
    Turkish text. # Adım 4 sorar: "Eğitim hedefinizi seçin"
    Which is correct. Neither. The wizard prints '[5/9] Training Objective' and the English prompt 'Choose your training objective:'. TR also translates a prompt string that is never shown in Turkish.
    Proposed correction (Turkish text for the -tr page). # Adım 5/9 sorar: "Choose your training objective:" (wizard çıktısı yalnızca İngilizcedir)

  • DOC-TR06-041 (TR mirror, Low) — TR mirror drift in docs/guides/safety_compliance.md: Previous versions only evaluated the response
    severity Low
    Where. EN docs/guides/safety_compliance.md:21 · TR docs/guides/safety_compliance-tr.md:29-31
    English text. Previous versions only evaluated the response
    Turkish text. Önceki sürümler yalnızca yanıtı değerlendirir
    Which is correct. EN (past tense); TR tense slip, no substantive change.
    Proposed correction (Turkish text for the -tr page). Önceki sürümler yalnızca yanıtı değerlendiriyordu; bu, bağlama bağlı güvensiz çıktıları gözden kaçırabilirdi.

  • DOC-TR06-042 (TR mirror, Low) — TR mirror drift in docs/guides/troubleshooting.md: ### ValueError: Unknown trainer_type
    severity Low
    Where. EN docs/guides/troubleshooting.md:199 · TR docs/guides/troubleshooting-tr.md:209
    English text. ### ValueError: Unknown trainer_type
    Turkish text. ### ValueError: Unknown trainer_type
    Which is correct. Neither; Pydantic rejects it at config load.
    Proposed correction. ### Input should be 'sft', 'orpo', 'dpo', 'simpo', 'kto' or 'grpo' (training.trainer_type)

  • DOC-TR06-043 (TR mirror, Low) — TR mirror drift in docs/guides/troubleshooting.md: ### KeyError: Dataset must contain 'chosen' and 'rejected' columns
    severity Low
    Where. EN docs/guides/troubleshooting.md:208 · TR docs/guides/troubleshooting-tr.md:218
    English text. ### KeyError: Dataset must contain 'chosen' and 'rejected' columns
    Turkish text. aynı başlık
    Which is correct. Neither; message differs.
    Proposed correction. ### KeyError: DPO trainer requires 'chosen' and 'rejected' columns, but found: ...

  • DOC-TR06-044 (TR mirror, Low) — TR mirror drift in docs/guides/troubleshooting.md: training -> learning_rate
    severity Low
    Where. EN docs/guides/troubleshooting.md:233-237 · TR docs/guides/troubleshooting-tr.md:244-248
    English text. training -> learning_rate
    Turkish text. training -> learning_rate
    Which is correct. Neither; actual: training.learning_rate / 'Input should be a valid number, unable to parse string as a number'.
    Proposed correction. text\nConfiguration validation failed: 1 validation error for ForgeConfig\ntraining.learning_rate\n Input should be a valid number, unable to parse string as a number [type=float_parsing, input_value='not_a_number']\n

  • DOC-TR06-045 (TR mirror, Low) — TR mirror drift in docs/guides/troubleshooting.md: --dry-run lists all resolved parameter values
    severity Low
    Where. EN docs/guides/troubleshooting.md:255 · TR docs/guides/troubleshooting-tr.md:271-272
    English text. --dry-run lists all resolved parameter values
    Turkish text. Çözümlenmiş tüm parametre değerlerini listeleyen forgelm --config job.yaml --dry-run
    Which is correct. Neither; dry-run prints a curated summary.
    Proposed correction (Turkish text for the -tr page). Geçerli alanları görmek için: docs/reference/configuration-tr.md'ye bakın; --dry-run yalnızca seçilmiş bir özet yazdırır ve config'in geçerli olduğunu doğrular.

  • DOC-TR08-029 (TR mirror, Low) — TR mirror drift in docs/guides/air_gap_deployment.md: §Air-gap pre-cache
    severity Low
    Where. EN docs/reference/audit_event_catalog.md:90 · TR docs/guides/air_gap_deployment-tr.md:244
    English text. §Air-gap pre-cache
    Turkish text. §Air-gap ön-cache
    Which is correct. EN; TR catalog heading is still 'Air-gap pre-cache' (audit_event_catalog-tr.md:90)
    Proposed correction. docs/reference/audit_event_catalog-tr.md §Air-gap pre-cache

  • DOC-TR08-030 (TR mirror, Low) — TR mirror drift in docs/guides/air_gap_deployment.md: Every step emits structured audit events (cache.populate_)
    severity Low
    Where. EN docs/guides/air_gap_deployment.md:30 · TR docs/guides/air_gap_deployment-tr.md:30
    English text. Every step emits structured audit events (cache.populate_
    )
    Turkish text. Her adım yapılandırılmış audit event'leri üretir (cache.populate_*)
    Which is correct. Neither: only the cache-models / cache-tasks steps emit them; tar/rsync and doctor do not, and audit is best-effort.
    Proposed correction (Turkish text for the -tr page). cache-models ve cache-tasks adımları yapılandırılmış audit event'leri (cache.populate_*) üretir (best-effort); tar/rsync ve doctor adımları üretmez.

  • DOC-TR08-031 (TR mirror, Low) — TR mirror drift in docs/guides/air_gap_deployment.md: forgelm doctor emits one row per probed extra (nine as of this writing)
    severity Low
    Where. EN docs/guides/air_gap_deployment.md:122 · TR docs/guides/air_gap_deployment-tr.md:122
    English text. forgelm doctor emits one row per probed extra (nine as of this writing)
    Turkish text. forgelm doctor prob edilen her extra için bir satır yazar (bu yazı itibarıyla dokuz tane)
    Which is correct. Neither: code probes 10 extras (qlora, unsloth, distributed, eval, tracking, tracking-mlflow, export, ingestion, ingestion-pii-ml, ingestion-scale).
    Proposed correction (Turkish text for the -tr page). forgelm doctor prob edilen her extra için bir satır yazar (bu yazı itibarıyla on tane; sayı için forgelm/cli/subcommands/_doctor.py içindeki _OPTIONAL_EXTRAS kaynak kabul edilir).

  • DOC-TR08-032 (TR mirror, Low) — TR mirror drift in docs/guides/cicd_pipeline.md: GitLab image: forgelm:latest script: forgelm ...; docker run ... -v $(pwd)/output:/workspace/output
    severity Low
    Where. EN docs/guides/cicd_pipeline.md:124-132,147-164 · TR docs/guides/cicd_pipeline-tr.md:130-138,157-170
    English text. GitLab image: forgelm:latest script: forgelm ...; docker run ... -v $(pwd)/output:/workspace/output
    Turkish text. aynı
    Which is correct. Neither; verified-as-broken example in EN
    Proposed correction (Turkish text for the -tr page). Image'ın entrypoint'i forgelm ise script içinde forgelm çağırmak yerine yalnızca argüman verin; çıktı volume'unun eğitim output_dir'i ile aynı yola bağlandığını doğrulayın (config'te training.output_dir: /workspace/output).

  • DOC-TR08-033 (TR mirror, Low) — TR mirror drift in docs/guides/cicd_pipeline.md: model_path ./checkpoints/final_model.staging.<run_id>
    severity Low
    Where. EN docs/guides/cicd_pipeline.md:209 · TR docs/guides/cicd_pipeline-tr.md:215
    English text. model_path ./checkpoints/final_model.staging.<run_id>
    Turkish text. aynı
    Which is correct. Neither exact: trainer sends the absolute staging path (trainer.py abspath of final_model.staging.<run_id>) via notify_awaiting_approval(run_name, model_path); the real event also carries title/text.
    Proposed correction (Turkish text for the -tr page). model_path mutlak staging dizinidir (<output_dir>/final_model.staging.<run_id>); run_id payload'da ayrı alan değildir.

  • DOC-TR08-034 (TR mirror, Low) — TR mirror drift in docs/guides/cicd_pipeline.md: full 5-event surface
    severity Low
    Where. EN docs/guides/cicd_pipeline.md:213 · TR docs/guides/cicd_pipeline-tr.md:219-221
    English text. full 5-event surface
    Turkish text. tam 5-event yüzeyi
    Which is correct. Neither; catalog table has a different count (verified stale)
    Proposed correction (Turkish text for the -tr page). Webhook yaşam döngüsü tablosunun güncel event listesine bakın (docs/reference/audit_event_catalog-tr.md); sayıyı metne yazmayın.

  • DOC-TR08-047 (TR mirror, Low) — TR mirror drift in docs/guides/iso_soc2_deployer_guide.md: ### Q1 ... ### Q8
    severity Low
    Where. EN docs/guides/iso_soc2_deployer_guide.md:95-260 · TR docs/guides/iso_soc2_deployer_guide-tr.md:96-259
    English text. ### Q1 ... ### Q8
    Turkish text. ### S1 ... ### S8
    Which is correct. Both fine individually; cross-doc references from TR docs (human_approval_gate-tr.md:232 '§"Q5"') are now dangling.
    Proposed correction (Turkish text for the -tr page). Başlıkları 'S' olarak tutup referansı §"S5" yapın.

  • DOC-TR08-048 (TR mirror, Low) — TR mirror drift in docs/guides/iso_soc2_deployer_guide.md: pip-audit nightly + bandit; Subscribe nightly SBOM diffs; gh release download v0.5.5 --pattern 'sbom-'; CycloneDX lists every transitive de…
    severity Low
    Where. EN docs/guides/iso_soc2_deployer_guide.md:35-38,87-88,198-213 · TR docs/guides/iso_soc2_deployer_guide-tr.md:37-39,88-89,198-213
    English text. pip-audit nightly + bandit; Subscribe nightly SBOM diffs; gh release download v0.5.5 --pattern 'sbom-
    '; CycloneDX lists every transitive dependency
    Turkish text. aynı
    Which is correct. Neither (verified misleading/broken): claims about schedules/artefacts not backed by workflow/release assets.
    Proposed correction (Turkish text for the -tr page). Yalnızca depoda gerçekten bulunan iş akışlarını ve release varlıklarını yazın (tools/generate_sbom.py); sürüm numarasını sabit yazmak yerine 'son release' ifadesini kullanın.

  • DOC-TR08-049 (TR mirror, Low) — TR mirror drift in docs/guides/iso_soc2_deployer_guide.md: audit.classifier_load_failed event fires / warning ALSO fires
    severity Low
    Where. EN docs/guides/iso_soc2_deployer_guide.md:251-252,278-281 · TR docs/guides/iso_soc2_deployer_guide-tr.md:252,280-281
    English text. audit.classifier_load_failed event fires / warning ALSO fires
    Turkish text. event yangın + ... DA yangın eder
    Which is correct. EN; TR is a literal mistranslation of 'fires' (yangın = fire).
    Proposed correction. audit.classifier_load_failed event'i tetiklenir + ... data.erasure_warning_memorisation DA tetiklenir.

  • DOC-TR08-050 (TR mirror, Low) — TR mirror drift in docs/guides/iso_soc2_deployer_guide.md: JSON envelope { matches: [...], match_count: N }
    severity Low
    Where. EN docs/guides/iso_soc2_deployer_guide.md:264-267 · TR docs/guides/iso_soc2_deployer_guide-tr.md:266
    English text. JSON envelope { matches: [...], match_count: N }
    Turkish text. JSON envelope { matches: [...], match_count: N } döner
    Which is correct. Neither: reverse-pii reports files_scanned[] with per-file match_count (_reverse_pii.py L424) and an audit event with query_hash.
    Proposed correction (Turkish text for the -tr page). JSON zarfı dosya başına files_scanned[].match_count döner; audit event'te query_hash bulunur.

  • DOC-TR09-003 (TR mirror, Low) — TR mirror drift in docs/guides/library_api.md: (masked_text, counts) tuple
    severity Low
    Where. EN docs/guides/library_api.md:164 · TR docs/guides/library_api-tr.md:165
    English text. (masked_text, counts) tuple
    Turkish text. (maskelenmiş_metin, sayımlar) tuple
    Which is correct. Cosmetic: a localised pseudo-identifier in a code span, no behavioural difference.
    Proposed correction. Keep the English identifiers: '(masked_text, counts) tuple'.

  • DOC-TR09-004 (TR mirror, Low) — TR mirror drift in docs/guides/pipeline.md: Cross-references link docs/roadmap.md and docs/guides/alignment.md
    severity Low
    Where. EN docs/guides/pipeline.md:309-315 · TR docs/guides/pipeline-tr.md:312-318
    English text. Cross-references link docs/roadmap.md and docs/guides/alignment.md
    Turkish text. TR links docs/roadmap-tr.md and alignment-tr.md and marks the roadmap/completed-phases links '(İngilizce)'
    Which is correct. TR is right for TR readers; no substantive divergence.
    Proposed correction. None.

  • DOC-TR09-005 (TR mirror, Low) — TR mirror drift in docs/guides/quickstart.md: # Recommended: enable 4-bit quantization (Linux)
    severity Low
    Where. EN docs/guides/quickstart.md:19 · TR docs/guides/quickstart-tr.md:19
    English text. # Recommended: enable 4-bit quantization (Linux)
    Turkish text. Same English comment left untranslated inside the TR code block.
    Which is correct. Cosmetic; code comments are English-only by project rule.
    Proposed correction. None needed.

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: lowMinor defect, inaccuracy or rough edgesource: review-2026-10Found by the October 2026 code and documentation reviewwave: 4Roadmap wave 4: low / info / watch, when touching the module

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions