[#1801 gate] Documentatie & compatibiliteitsmatrix klopt met gedrag #1849

New issue

Closed

opened 2026-08-29 12:37:40 +00:00 by brenno · 0 comments

brenno commented

2026-08-29 12:37:40 +00:00

Owner

Context

Onderdeel van de voltooiingscriteria voor #1801 (implementatieplan-commentaar op het issue).

Wat gevraagd wordt

De shipped documentatie moet matchen met het daadwerkelijke gedrag:

FILE_FORMAT.md — ocideck_callouts-block, grammar, known-tokens, voorbeeld. Klopt dit met de geïmplementeerde codec?
USER_GUIDE.md (+ .nl.md) — beeldverwijzingen/markeringen/gebieden/pijlen sectie. Klopt de beschrijving met de editor?
KNOWN_LIMITATIONS.md (+ .nl.md) — plain Marp zonder --theme-set toont geen overlay (en geen split-layout). LaTeX degradeert arrows naar pin/region + tekst. Klopt dit?
SOURCE_MAP.md — nieuwe bestanden (image_callout.dart, callout_codec.dart, image_viewport_geometry.dart, presentation_step_plan.dart, etc.) staan erin.
CHANGELOG.md — feature-vermelding.
Compatibiliteitsmatrix in IMAGE_CALLOUTS.md §5 — elke cel klopt met wat echt shipped.

Status

Slices hebben hun eigen docs-updates meegenomen, maar een cross-cutte audit dat alles consistent is ontbreekt.

Acceptatie

FILE_FORMAT.md klopt met codec
USER_GUIDE klopt met editor-gedrag
KNOWN_LIMITATIONS klopt met daadwerkelijke degradatie
SOURCE_MAP.md compleet
CHANGELOG.md vermeldt de feature
Compatibiliteitsmatrix §5 klopt

## Context Onderdeel van de voltooiingscriteria voor #1801 (implementatieplan-commentaar op het issue). ## Wat gevraagd wordt De shipped documentatie moet matchen met het daadwerkelijke gedrag: 1. **FILE_FORMAT.md** — `ocideck_callouts`-block, grammar, known-tokens, voorbeeld. Klopt dit met de geïmplementeerde codec? 2. **USER_GUIDE.md** (+ `.nl.md`) — beeldverwijzingen/markeringen/gebieden/pijlen sectie. Klopt de beschrijving met de editor? 3. **KNOWN_LIMITATIONS.md** (+ `.nl.md`) — plain Marp zonder `--theme-set` toont geen overlay (en geen split-layout). LaTeX degradeert arrows naar pin/region + tekst. Klopt dit? 4. **SOURCE_MAP.md** — nieuwe bestanden (`image_callout.dart`, `callout_codec.dart`, `image_viewport_geometry.dart`, `presentation_step_plan.dart`, etc.) staan erin. 5. **CHANGELOG.md** — feature-vermelding. 6. **Compatibiliteitsmatrix** in IMAGE_CALLOUTS.md §5 — elke cel klopt met wat echt shipped. ## Status Slices hebben hun eigen docs-updates meegenomen, maar een cross-cutte audit dat alles consistent is ontbreekt. ## Acceptatie - [ ] FILE_FORMAT.md klopt met codec - [ ] USER_GUIDE klopt met editor-gedrag - [ ] KNOWN_LIMITATIONS klopt met daadwerkelijke degradatie - [ ] SOURCE_MAP.md compleet - [ ] CHANGELOG.md vermeldt de feature - [ ] Compatibiliteitsmatrix §5 klopt

brenno added the

accepted

docs

in-progress

labels

2026-08-29 12:37:40 +00:00

brenno referenced this issue from a commit

2026-08-29 13:10:26 +00:00

test(callouts): acceptatiepoorten voor #1801 — escaping, privacy, mutatie, export, docs

brenno referenced this issue

2026-08-29 13:10:41 +00:00

test(callouts): acceptatiepoorten voor #1801 #1850