TR mirror drift in docs/reference/distributed_training.md: docker run --gpus all ... forgelm:full torchrun --nproc_per_node=4 -m forgelm.cli --config /workspace/config.yaml (DOC-TR04-006) #298

Wave 1 · theme D1-10: Documentation-only fixes · highest severity High · 1 finding(s) · effort docs fix

Summary

Neither. Dockerfile ENTRYPOINT ["forgelm"] prepends forgelm to the argument list, so the container runs forgelm torchrun --nproc_per_node=4 ..., an argparse error. The example needs --entrypoint torchrun.

Primary finding

DOC-TR04-006 — TR mirror drift in docs/reference/distributed_training.md: docker run --gpus all ... forgelm:full torchrun --nproc_per_node=4 -m forgelm.cli --config /workspace/config.yaml

severity High · already tracked: KNOWN-OPEN C31-DOCKER-RUNBOOK docs/roadmap/phase-16-trust-surface-hardening.md:689-695

Where. EN docs/reference/distributed_training.md:195-201 · TR docs/reference/distributed_training-tr.md:203-209

English text. docker run --gpus all ... forgelm:full torchrun --nproc_per_node=4 -m forgelm.cli --config /workspace/config.yaml

Turkish text. docker run --gpus all ... forgelm:full torchrun --nproc_per_node=4 -m forgelm.cli --config /workspace/config.yaml

Which is correct. Neither. Dockerfile ENTRYPOINT ["forgelm"] prepends forgelm to the argument list, so the container runs forgelm torchrun --nproc_per_node=4 ..., an argparse error. The example needs --entrypoint torchrun.

Proposed correction (Turkish text for the -tr page). docker run --gpus all \\n -v $(pwd)/my_config.yaml:/workspace/config.yaml \\n --shm-size=16g \\n --entrypoint torchrun forgelm:full \\n --nproc_per_node=4 -m forgelm.cli --config /workspace/config.yaml (ek olarak imajda deepspeed kurulu olmalı)

Acceptance criteria

• Each statement is re-checked against the code at fix time.
• Documentation listed above is corrected in English and in its Turkish mirror in the same PR.
• Every finding in this issue is resolved or explicitly closed with a reason.

_{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.}