Corrigeer handleiding: tabelstijl reist niet vanzelf mee in een Markdown-deck #2651

New issue

Closed

opened 2026-10-28 22:55:07 +00:00 by brenno · 2 comments

brenno commented

2026-10-28 22:55:07 +00:00

Owner

Probleem

docs/USER_GUIDE.nl.md (sectie tabelstijl rond regel 5871) zegt dat de tabelstijl met het bestand meereist en de ontvanger dezelfde tabel ziet. De stijlprofielwaarden zitten niet in een kale .md; docs/FILE_FORMAT.md beschrijft dat terecht en FileService past bij heropenen het lokaal actieve profiel toe. Een .ocideck-pakket bevat wel CSS voor externe Marp-weergave, maar OciDeck zelf kiest momenteel eveneens het lokale profiel (zie #2644). De ongeclausuleerde gebruikersbelofte is daarmee onjuist. De Engelse gids moet op dezelfde claim worden gecontroleerd.

Aanpak

Schrijf in beide gebruikersgidsen concreet wat bij een kale Markdown-presentatie, een .ocideck-pakket en een los .ocideckstyle-bestand meegaat. Maak onderscheid tussen openen in OciDeck en renderen met de meegeleverde Marp-CSS. Stem de uiteindelijke tekst af op de productkeuze en reparatie in #2644 en op de CSS-pariteit in #2650; tot die tijd mag er geen garantie staan dat de ontvanger dezelfde tabelstijl ziet.

Acceptatiecriteria

NL en EN beschrijven het daadwerkelijke stijlgedrag van alle drie formaten zonder een onjuiste portabiliteitsbelofte.
USER_GUIDE en FILE_FORMAT spreken elkaar niet tegen; de voorbeelden noemen een ontvanger met een ander lokaal actief profiel.
Documentatie- en linkcontrole zijn groen.

## Probleem `docs/USER_GUIDE.nl.md` (sectie tabelstijl rond regel 5871) zegt dat de tabelstijl met het bestand meereist en de ontvanger dezelfde tabel ziet. De stijlprofielwaarden zitten niet in een kale `.md`; `docs/FILE_FORMAT.md` beschrijft dat terecht en `FileService` past bij heropenen het lokaal actieve profiel toe. Een `.ocideck`-pakket bevat wel CSS voor externe Marp-weergave, maar OciDeck zelf kiest momenteel eveneens het lokale profiel (zie #2644). De ongeclausuleerde gebruikersbelofte is daarmee onjuist. De Engelse gids moet op dezelfde claim worden gecontroleerd. ## Aanpak Schrijf in beide gebruikersgidsen concreet wat bij een kale Markdown-presentatie, een `.ocideck`-pakket en een los `.ocideckstyle`-bestand meegaat. Maak onderscheid tussen openen in OciDeck en renderen met de meegeleverde Marp-CSS. Stem de uiteindelijke tekst af op de productkeuze en reparatie in #2644 en op de CSS-pariteit in #2650; tot die tijd mag er geen garantie staan dat de ontvanger dezelfde tabelstijl ziet. ## Acceptatiecriteria - NL en EN beschrijven het daadwerkelijke stijlgedrag van alle drie formaten zonder een onjuiste portabiliteitsbelofte. - USER_GUIDE en FILE_FORMAT spreken elkaar niet tegen; de voorbeelden noemen een ontvanger met een ander lokaal actief profiel. - Documentatie- en linkcontrole zijn groen.

brenno added the

docs

accepted

in-progress

labels

2026-10-28 22:55:07 +00:00

brenno commented

2026-10-28 23:35:22 +00:00

Author

Owner

Opgepakt. Tak: fix/logo-stijl-2640. Verwachte reikwijdte: USER_GUIDE nl+en over wat er van tabelstijl meereist.

brenno referenced this issue from a commit

2026-10-29 01:45:37 +00:00

docs: zeg waar een stijl wel en niet mee reist (#2643 #2651)

brenno referenced this issue from a pull request that will close it,

2026-10-29 01:45:49 +00:00

fix: stijl reist mee naast de markdown (#2640) #2655

brenno closed this issue

2026-10-29 01:51:55 +00:00

brenno commented

2026-10-29 01:52:45 +00:00

Author

Owner

Geland op main in 978b199646. De handleiding zegt wat er met kale markdown, een .ocideck en een .ocideckstyle meereist. Een ontvanger met een ander actief profiel ziet de tabel anders tot de sidecar erbij zit.

Geland op main in 978b199646c1c834b2bf348c30214ecce370898a. De handleiding zegt wat er met kale markdown, een .ocideck en een .ocideckstyle meereist. Een ontvanger met een ander actief profiel ziet de tabel anders tot de sidecar erbij zit.