Skip to content

[Wave 4] Low/info — TR mirror: docs/usermanuals/en/operations/ #818

Open

Description

@cemililik

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

Findings

  • DOC-TR15-006 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/operations/air-gap.md: ERROR: model "meta-llama/Llama-Guard-3-8B" not in local cache. Pre-cache from a connected machine: forgelm cache-models --safety …
    severity Low
    Where. EN docs/usermanuals/en/operations/air-gap.md:53-54 · TR docs/usermanuals/en/operations/air-gap.md:53-54
    English text. ERROR: model "meta-llama/Llama-Guard-3-8B" not in local cache. Pre-cache from a connected machine: forgelm cache-models --safety …
    Turkish text. Same literal, but second line translated: 'Bağlı bir makineden önceden cache'leyin: forgelm cache-models …'
    Which is correct. Neither: ForgeLM prints no such message (offline failures surface HF's own error). A console literal must never be translated; TR shows a message the program cannot emit in either language.
    Proposed correction (Turkish text for the -tr page). Kod bloğunu gerçek bir HF offline hata çıktısıyla değiştirin ya da 'Cache'te olmayan bir modelde yükleme, HuggingFace'in offline-mod hatasıyla başarısız olur' şeklinde düz metne çevirin; konsol çıktısı çevrilmesin.

  • DOC-TR15-007 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/operations/experiment-tracking.md: ...TensorBoardCallback raises loudly if neither is present.
    severity Low
    Where. EN docs/usermanuals/en/operations/experiment-tracking.md:61 · TR docs/usermanuals/en/operations/experiment-tracking.md:61
    English text. ...TensorBoardCallback raises loudly if neither is present.
    Turkish text. ...hiçbiri yoksa TensorBoardCallback requires tensorboard to be installed yüksek sesle başarısız olur. (English fragment spliced into Turkish sentence)
    Which is correct. EN sentence is clear; TR is garbled but conveys the same meaning. Both are moot: tensorboard>=2.15 is a core dependency in pyproject.toml.
    Proposed correction (Turkish text for the -tr page). TensorBoard tensorboard çekirdek bağımlılık olarak birlikte kurulur; ayrıca bir şey kurmanız gerekmez.

  • DOC-TR15-008 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/operations/iso-soc2-deployer.md: Links point to the English guide/reference/QMS files.
    severity Low
    Where. EN docs/usermanuals/en/operations/iso-soc2-deployer.md:36-53 · TR docs/usermanuals/tr/operations/iso-soc2-deployer.md:36-53
    English text. Links point to the English guide/reference/QMS files.
    Turkish text. Links point to the existing -tr.md mirrors (all nine verified present in docs/).
    Which is correct. TR is correct and follows the localisation mirror rule; no content divergence.
    Proposed correction (Turkish text for the -tr page). Değişiklik gerekmez.

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.

Activity

  1. added
    documentationImprovements or additions to documentation
    i18nEnglish/Turkish documentation mirror
    severity: lowMinor defect, inaccuracy or rough edge
    source: review-2026-10Found by the October 2026 code and documentation review
    wave: 4Roadmap wave 4: low / info / watch, when touching the module
    on Oct 9, 2026
  2. cemililik commented on Oct 11, 2026

    @cemililik
    CollaboratorAuthor

    Where to start

    Thanks for taking a look. Please confirm the issue is unassigned and comment before starting so work does not overlap.

    Start with these files on development:

    Replace invented/translated offline terminal output with prose describing the actual upstream error. State that TensorBoard is a core dependency and repair the garbled TR sentence. Close DOC-TR15-008 with a reason: the TR page already links the correct TR documents, so it needs no edit. Do not rewrite unrelated offline-enforcement claims.

    Current TR links were checked individually; preserve them.

    Run the focused tests:

    pytest tests/test_model.py tests/test_cli.py --no-cov

    Run these guards/checks as applicable to the changed files:

    ruff format --check tests/test_model.py tests/test_cli.py
    ruff check tests/test_model.py tests/test_cli.py
    python3 tools/check_bilingual_parity.py --strict
    python3 tools/check_bilingual_code_blocks.py --strict
    python3 tools/check_anchor_resolution.py --strict
    python3 tools/check_tr_links_prefer_mirror.py --strict
    python3 tools/check_usermanual_self_contained.py --strict
    python3 tools/check_usermanual_schema_drift.py --strict

    If user-facing documentation changes, update the existing Turkish mirror in the same PR; keep commands, code and terminal output in English and structurally aligned. English-only contributor standards need no new mirror.

    Open the PR against development with Fixes #818 once every finding is resolved or explicitly closed with a reason; use Refs #818 for partial work and list the resolved finding IDs.

  3. added
    help wantedExtra attention is needed
    and removed on Oct 15, 2026
  4. cemililik commented on Oct 15, 2026

    @cemililik
    CollaboratorAuthor

    I'm removing good first issue here and marking this help wanted: it needs natural Turkish written or reviewed by a native or near-native speaker. docs/standards/localization.md does not accept unreviewed machine translation (see its "No machine-translation output" rule), so please only claim this issue if that describes you, and say in the PR who reviewed the Turkish text.

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 documentationhelp wantedExtra attention is neededi18nEnglish/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