Repository navigation
[Wave 4] Low/info — TR mirror: docs/guides/ #805
Description
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. ENdocs/guides/alignment.md:181· TRdocs/guides/alignment-tr.md:198-200
English text. The format component returns 1.0 when the generation ends withAnswer: <value>
Turkish text. Format bileşeni, üretimAnswer: <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ındaAnswer: <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. ENdocs/guides/alignment.md:210-214· TRdocs/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. ENdocs/guides/safety_compliance.md:21· TRdocs/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. ENdocs/guides/troubleshooting.md:199· TRdocs/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. ENdocs/guides/troubleshooting.md:208· TRdocs/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. ENdocs/guides/troubleshooting.md:233-237· TRdocs/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. ENdocs/guides/troubleshooting.md:255· TRdocs/guides/troubleshooting-tr.md:271-272
English text. --dry-run lists all resolved parameter values
Turkish text. Çözümlenmiş tüm parametre değerlerini listeleyenforgelm --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-runyalnı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. ENdocs/reference/audit_event_catalog.md:90· TRdocs/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. ENdocs/guides/air_gap_deployment.md:30· TRdocs/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-modelsvecache-tasksadımları yapılandırılmış audit event'leri (cache.populate_*) üretir (best-effort); tar/rsync vedoctoradı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. ENdocs/guides/air_gap_deployment.md:122· TRdocs/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 doctorprob edilen her extra için bir satır yazar (bu yazı itibarıyla on tane; sayı içinforgelm/cli/subcommands/_doctor.pyiçindeki_OPTIONAL_EXTRASkaynak 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. ENdocs/guides/cicd_pipeline.md:124-132,147-164 · TRdocs/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'iforgelmisescriptiçindeforgelmçağırmak yerine yalnızca argüman verin; çıktı volume'unun eğitimoutput_dir'i ile aynı yola bağlandığını doğrulayın (config'tetraining.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. ENdocs/guides/cicd_pipeline.md:209· TRdocs/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_pathmutlak staging dizinidir (<output_dir>/final_model.staging.<run_id>);run_idpayload'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. ENdocs/guides/cicd_pipeline.md:213· TRdocs/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. ENdocs/guides/iso_soc2_deployer_guide.md:95-260· TRdocs/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. ENdocs/guides/iso_soc2_deployer_guide.md:35-38,87-88,198-213 · TRdocs/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. ENdocs/guides/iso_soc2_deployer_guide.md:251-252,278-281 · TRdocs/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_failedevent'i tetiklenir + ...data.erasure_warning_memorisationDA 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. ENdocs/guides/iso_soc2_deployer_guide.md:264-267· TRdocs/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şınafiles_scanned[].match_countdöner; audit event'tequery_hashbulunur. -
DOC-TR09-003 (TR mirror, Low) — TR mirror drift in docs/guides/library_api.md:
(masked_text, counts)tuple
severity Low
Where. ENdocs/guides/library_api.md:164· TRdocs/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. ENdocs/guides/pipeline.md:309-315· TRdocs/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. ENdocs/guides/quickstart.md:19· TRdocs/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.
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fieldsTodo
Activity