Skip to content

docs/usermanuals/en/getting-started/first-run.md: broken example — forgelm chat ./checkpoints/customer-support opens the trained model with a forgelm> prompt. (DOC-D3B04B-004) #224

Open

Description

@cemililik

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

Summary

Chat fails to load a model from the run root, which has no config.json or weights.

Primary finding

DOC-D3B04B-004 — docs/usermanuals/en/getting-started/first-run.md: broken example — forgelm chat ./checkpoints/customer-support opens the trained model with a forgelm> prompt.

severity High

Where. docs/usermanuals/en/getting-started/first-run.md:153-158 (Turkish mirror: docs/usermanuals/tr/getting-started/first-run.md:154-155) · type: broken example

The document says. forgelm chat ./checkpoints/customer-support opens the trained model with a forgelm> prompt.

What the code does. The trained model is saved in <output_dir>/<final_model_dir> = ./checkpoints/customer-support/final_model (forgelm/trainer.py:1590-1593; quickstart's own auto-chat uses that path, forgelm/cli/subcommands/_quickstart.py:160-170). The REPL prompt is '> ' (forgelm/chat.py:123).

Code references. forgelm/trainer.py:1590-1593, forgelm/cli/subcommands/_quickstart.py:160-170, forgelm/chat.py:123

User impact. Chat fails to load a model from the run root, which has no config.json or weights.

Proposed correction. $ forgelm chat ./checkpoints/customer-support/final_model (prompt shown as > )

Turkish mirror. the Turkish page has the same error; fix both in the same PR

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationseverity: highWrong behaviour or a false claim users rely onsource: review-2026-10Found by the October 2026 code and documentation reviewwave: 1Roadmap wave 1: high severity, small effort

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions