Skip to content

[Wave 4] Low/info — TR mirror: docs/usermanuals/en/getting-started/ #817

Open

Description

@cemililik

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

Findings

  • DOC-TR15-002 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/getting-started/first-run.md: Sample log dated 2026-04-28; chat transcript in English ('how do I cancel my subscription?').
    severity Low
    Where. EN docs/usermanuals/en/getting-started/first-run.md:140-149,155-157 · TR docs/usermanuals/tr/getting-started/first-run.md:140-149,155-158
    English text. Sample log dated 2026-04-28; chat transcript in English ('how do I cancel my subscription?').
    Turkish text. Sample log dated 2026-04-29; chat transcript localised to Turkish.
    Which is correct. Neither is real output; both are illustrative. The date and chat-language difference is cosmetic. Substantive error (DPO/benchmark/Llama Guard lines under an SFT-only template) is identical in both.
    Proposed correction (Turkish text for the -tr page). Tarih farkı önemsiz; örnek log gerçek bir SFT koşusuna göre (DPO/benchmark/Llama Guard satırları olmadan) yeniden yazılırken EN ile aynı tarih kullanılsın.

  • DOC-TR15-003 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/getting-started/introduction.md: Compliance teams: EU AI Act, GDPR, or sector-specific requirements; section 6 'Compliance — Annex IV, audit logs, GDPR'.
    severity Low
    Where. EN docs/usermanuals/en/getting-started/introduction.md:17,71 · TR docs/usermanuals/tr/getting-started/introduction.md:17,71
    English text. Compliance teams: EU AI Act, GDPR, or sector-specific requirements; section 6 'Compliance — Annex IV, audit logs, GDPR'.
    Turkish text. EU AI Act, KVKK / GDPR ...; 'Uyumluluk — Annex IV, audit log, KVKK / GDPR'.
    Which is correct. EN is the narrower, code-backed statement (GDPR primitives purge/reverse-pii exist; no KVKK-specific code in forgelm/). The manual's own gdpr page is titled 'GDPR / KVKK' (EN too) and says KVKK 'mirrors' GDPR, so TR is consistent with the manual but adds a regulatory scope claim the toolkit does not implement or test.
    Proposed correction (Turkish text for the -tr page). Ya EN ile hizalayın ('EU AI Act, GDPR veya sektör-özgü gereklere') ya da KVKK ifadesini 'GDPR (KVKK ile benzer ilkeler)' şeklinde yumuşatıp gdpr sayfasına bağlayın.

  • DOC-TR15-004 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/getting-started/project-layout.md: 'ForgeLM uses these path conventions — change them with command-line flags but keep them consistent across a project:'
    severity Low
    Where. EN docs/usermanuals/en/getting-started/project-layout.md:76 · TR project-layout.md:74-76 (sentence absent)
    English text. 'ForgeLM uses these path conventions — change them with command-line flags but keep them consistent across a project:'
    Turkish text. Section heading followed directly by the table; intro sentence omitted (TR is 2 lines shorter).
    Which is correct. Neither carries a substantive claim (EN sentence is itself loosely worded: several overrides are YAML keys/env vars, not flags). Omission is harmless.
    Proposed correction (Turkish text for the -tr page). Gerekirse: 'ForgeLM bu yol konvansiyonlarını kullanır — CLI bayrağı, YAML anahtarı veya ortam değişkeniyle değiştirebilirsiniz, ancak bir proje boyunca tutarlı kalın:'

  • DOC-TR15-005 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/getting-started/project-layout.md: dev config: 1 epoch, small subset, no safety eval.
    severity Low
    Where. EN project-layout.md:88 'no safety eval' · TR project-layout.md:86 'eval kapalı'
    English text. dev config: 1 epoch, small subset, no safety eval.
    Turkish text. dev config: 1 epoch, küçük subset, eval kapalı.
    Which is correct. TR is closer to the YAML example (benchmark.enabled false AND safety.enabled false); EN understates.
    Proposed correction (Turkish text for the -tr page). EN'i TR ile hizalayın: 'benchmark ve güvenlik eval kapalı'; TR değişmez.

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