Skip to content

Commit 0766e94

Browse files
Venius24claude
andauthored
docs(usermanuals): name the real KTO columns on the alignment overview page (#972)
Fixes #965 The KTO bullet on the Alignment overview page named the fields `(prompt, response, good?)`; the loader requires `prompt`, `completion` and a boolean `label`. Both the English page and the Turkish mirror (same line, same structure, only the field names and the true/false explanation changed) now say `(prompt, completion, label)`. A `### Fixed` entry is added under `[Unreleased]` in `CHANGELOG.md`. Checks run, all passing with `--strict`: `check_bilingual_parity`, `check_bilingual_code_blocks`, `check_anchor_resolution`, `check_tr_links_prefer_mirror`, `check_usermanual_self_contained`. Docs only, no code changed. The Turkish wording is mine and could use a native read. ## Summary by Sourcery Correct the documented KTO dataset fields to match the loader’s expected prompt, completion, and label schema. Bug Fixes: - Correct the KTO field names and boolean label guidance on the English and Turkish alignment overview pages. Documentation: - Document the KTO alignment overview correction in the unreleased changelog. Signed-off-by: Venius24 <WonderRebirth@mail.ru> Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
1 parent 9e6a8b2 commit 0766e94

3 files changed

Lines changed: 5 additions & 2 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,9 @@ All notable changes to ForgeLM are documented here.
5959

6060
### Fixed
6161

62+
- Fix the KTO bullet on the Alignment overview user-manual page (English and Turkish): it named the
63+
fields `(prompt, response, good?)`, but the KTO loader reads `prompt`, `completion` and a boolean
64+
`label` (#965).
6265
- Make the site's code comments readable: `--code-comment` was `#6a6f80`, 3.8:1 on the dark code
6366
surface, below the 4.5:1 AA floor, and it colours code comments, terminal and code-block title bars,
6467
language tags, copy buttons and the wizard's YAML pane header and comment lines. It is now `#8f96a8`,

‎docs/usermanuals/en/concepts/alignment-overview.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ After SFT, the model produces well-formatted outputs but quality varies — some
5353
The differences:
5454
- **DPO** — learns from `(chosen, rejected)` pairs against a reference model. Best-studied, most stable.
5555
- **SimPO** — same as DPO but skips the reference model. Lower memory, slightly less stable.
56-
- **KTO** — learns from binary `(prompt, response, good?)` signals. Use when you only have thumbs-up/down feedback.
56+
- **KTO** — learns from binary `(prompt, completion, label)` rows, where `label` is `true` for a desirable response and `false` for an undesirable one. Use when you only have thumbs-up/down feedback.
5757
- **ORPO** — combines SFT and preference loss in a single pass. Faster wall-clock; less flexible than separate stages.
5858

5959
### Problem 3: Reasoning

‎docs/usermanuals/tr/concepts/alignment-overview.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ SFT'den sonra model iyi formatta çıktı üretir ama kalite değişken — baze
5353
Farklar:
5454
- **DPO** — referans modele karşı `(chosen, rejected)` çiftlerinden öğrenir. En çok çalışılmış, en kararlı.
5555
- **SimPO** — DPO ile aynı ama referans modeli atlar. Daha az bellek, biraz daha az kararlılık.
56-
- **KTO** — ikili `(prompt, response, iyi mi?)` sinyallerinden öğrenir. Sadece thumbs-up/down geri bildiriminiz varsa kullanın.
56+
- **KTO** — ikili `(prompt, completion, label)` satırlarından öğrenir; `label`, istenen yanıt için `true`, istenmeyen yanıt için `false` olur. Sadece thumbs-up/down geri bildiriminiz varsa kullanın.
5757
- **ORPO** — SFT ve tercih kaybını tek geçişte birleştirir. Daha hızlı wall-clock; ayrı aşamalardan daha az esneklik.
5858

5959
### Problem 3: Akıl yürütme

0 commit comments

Comments
 (0)