[#1801 gate] Functionele + nieuwkomer-test van de volledige user journey #1848

Closed
opened 2026-08-29 12:37:39 +00:00 by brenno · 2 comments
Owner

Context

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

Wat gevraagd wordt

De complete #1801-user journey van begin tot eind gelopen, vanuit de gebruiker — niet vanuit de code:

  1. Een bulletsImage-slide met een afbeelding maken.
  2. Callouts toevoegen: bullet selecteren, op de afbeelding klikken om een target te plaatsen, target verplaatsen, meerdere targets per bullet.
  3. Presentatiemodus kiezen (pin/region/arrow) en switchen.
  4. Reveal aanzetten (steps) en presenteren: bullet + markeringen verschijnen samen per klik.
  5. Exporteren naar PDF, PPTX, ODP, HTML, LaTeX — markeringen zichtbaar in elke export.
  6. Bestand opslaan, sluiten, heropenen — callouts behouden.
  7. In een tekst editor het .md openen: (A) leesbaar, front-matter-block leesbaar en hand-editable.

Daarnaast: nieuwkomer-test — iemand die OciDeck niet kent kan zonder uitleg een callout aanmaken en presenteren.

Gebruik de functionele-tester- en gebruikerstest-skills.

Acceptatie

  • Volledige user journey gelopen en gedocumenteerd
  • Nieuwkomer-test uitgevoerd (of minimaal: de reis zonder uitleg haalbaar)
  • Gevonden problemen als issues of opgelost
## Context Onderdeel van de voltooiingscriteria voor #1801 (implementatieplan-commentaar op het issue). ## Wat gevraagd wordt De complete #1801-user journey van begin tot eind gelopen, vanuit de gebruiker — niet vanuit de code: 1. Een bulletsImage-slide met een afbeelding maken. 2. Callouts toevoegen: bullet selecteren, op de afbeelding klikken om een target te plaatsen, target verplaatsen, meerdere targets per bullet. 3. Presentatiemodus kiezen (pin/region/arrow) en switchen. 4. Reveal aanzetten (steps) en presenteren: bullet + markeringen verschijnen samen per klik. 5. Exporteren naar PDF, PPTX, ODP, HTML, LaTeX — markeringen zichtbaar in elke export. 6. Bestand opslaan, sluiten, heropenen — callouts behouden. 7. In een tekst editor het `.md` openen: `(A)` leesbaar, front-matter-block leesbaar en hand-editable. Daarnaast: **nieuwkomer-test** — iemand die OciDeck niet kent kan zonder uitleg een callout aanmaken en presenteren. Gebruik de `functionele-tester`- en `gebruikerstest`-skills. ## Acceptatie - [ ] Volledige user journey gelopen en gedocumenteerd - [ ] Nieuwkomer-test uitgevoerd (of minimaal: de reis zonder uitleg haalbaar) - [ ] Gevonden problemen als issues of opgelost
Author
Owner

Opgepakt. Functionele reis + nieuwkomer-test van de #1801-callouts. Draait de app; volgt serieel na #1847.

Opgepakt. Functionele reis + nieuwkomer-test van de #1801-callouts. Draait de app; volgt serieel na #1847.
Author
Owner

Beide helften uitgevoerd: de functionele reis én de nieuwkomer-test, allebei met de app draaiend.

De reis (stap voor stap)

Stap Uitkomst
bulletsImage-dia met afbeelding maken goed
callouts toevoegen, verplaatsen, meerdere targets werkte, met bevindingen — zie hieronder
pin / gebied / pijl kiezen en wisselen goed
stap-voor-stap onthullen en presenteren goed; bullet en markeringen komen samen, terug verbergt in omgekeerde volgorde
exporteren naar PDF, PPTX, ODP, HTML, LaTeX PDF/PPTX/ODP goed na #1857 · HTML deels (#1855) · LaTeX compileerde niet — gerepareerd
opslaan, sluiten, heropenen was stuk — gerepareerd
.md met de hand lezen en bewerken goed; een handbewerking komt ongeschonden terug, inclusief commentaarregels en een moedwillig kapotte regel

Wat gerepareerd is

Een callout uit de interface overleefde het opslaan niet (#1858). De editor schreef de zichtbare (A) niet in de opsommingsregel en de dia kreeg geen anker, dus het front-matter-blok belandde onder een lege sleutel en hoorde bij heropenen bij geen enkele dia. Alles wat je in de dialoog deed was weg. Handgeschreven decks werkten al — daarom viel het niet eerder op.

De dialoog rekende vanaf een verouderde kopie (#1865). Gevonden door de nieuwkomer-test: hij wordt bij het openen gevuld en daarna niet opnieuw opgebouwd, dus een tweede verwijzing wiste de letter van de eerste. Die callout raakte los van zijn regel en was in de dialoog niet meer te bereiken; herstellen maakte het erger.

De LaTeX/Beamer-export compileerde niet zodra er een verwijzing op stond (#1858). De TikZ-code tekende met ocideckTableAccent, een kleur die alleen de article-preamble definieerde.

Nieuwkomer-test — het platte antwoord

Nee, een nieuwkomer haalt dit niet zonder uitleg. Hij vindt de knop met moeite, raadt de bediening, en kon zijn fout niet meer weg krijgen. Dat laatste is nu gerepareerd; de instap niet.

Wat wél meteen werkte: gebied tekenen (slepen, hoekgrepen — eerste keer raak), de live dia-miniatuur die (A) in de regel ziet verschijnen, en presenteren met stap-voor-stap. De tester noemde dat laatste "de functie op zijn best".

Wat niet: #1860 — de dialoog vertelt niet wat je moet doen. "Toevoegen" plaatst de markering zelf al op het midden, de instructie vraagt om iets selecteren wat niet selecteerbaar is, en de drie presentatiewijzen doen drie verschillende dingen afhankelijk van wanneer je drukt. Aanvullend #1861 (bewoording en het beschrijvingsveld dat de halve waarheid vertelt) en #1862 (Escape verlaat de presentatie niet, terwijl de documentatie zegt van wel).

Zie ook #1859, dat hetzelfde scherm uit de code beoordeelt en op dezelfde plekken uitkomt.

Niet getoetst

  • OciWacht op een callout-beschrijving langs de redactieroute: de privacycontrole staat in deze installatie uit, en die aanzetten is een instelling van de gebruiker. Dat een waarde écht uit de PDF verdwijnt is wel bewezen, via de TLP-route (dia op RED, presentatie op CLEAR: de dia komt niet in de export, en ook niet het persoonsgegeven in de callout-beschrijving).
  • Compileren van de .tex: geen TeX op deze machine. De reparatie is getoetst op de gegenereerde preamble, niet op een gecompileerd document.

Daarmee is deze poort af. De openstaande punten leven verder in #1859-#1862.

Beide helften uitgevoerd: de functionele reis én de nieuwkomer-test, allebei met de app draaiend. ## De reis (stap voor stap) | Stap | Uitkomst | |---|---| | bulletsImage-dia met afbeelding maken | goed | | callouts toevoegen, verplaatsen, meerdere targets | werkte, met bevindingen — zie hieronder | | pin / gebied / pijl kiezen en wisselen | goed | | stap-voor-stap onthullen en presenteren | goed; bullet en markeringen komen samen, terug verbergt in omgekeerde volgorde | | exporteren naar PDF, PPTX, ODP, HTML, LaTeX | PDF/PPTX/ODP goed na #1857 · HTML deels (#1855) · LaTeX **compileerde niet** — gerepareerd | | opslaan, sluiten, heropenen | **was stuk** — gerepareerd | | `.md` met de hand lezen en bewerken | goed; een handbewerking komt ongeschonden terug, inclusief commentaarregels en een moedwillig kapotte regel | ## Wat gerepareerd is **Een callout uit de interface overleefde het opslaan niet** (#1858). De editor schreef de zichtbare `(A)` niet in de opsommingsregel en de dia kreeg geen anker, dus het front-matter-blok belandde onder een lege sleutel en hoorde bij heropenen bij geen enkele dia. Alles wat je in de dialoog deed was weg. Handgeschreven decks werkten al — daarom viel het niet eerder op. **De dialoog rekende vanaf een verouderde kopie** (#1865). Gevonden door de nieuwkomer-test: hij wordt bij het openen gevuld en daarna niet opnieuw opgebouwd, dus een tweede verwijzing wiste de letter van de eerste. Die callout raakte los van zijn regel en was in de dialoog niet meer te bereiken; herstellen maakte het erger. **De LaTeX/Beamer-export compileerde niet** zodra er een verwijzing op stond (#1858). De TikZ-code tekende met `ocideckTableAccent`, een kleur die alleen de article-preamble definieerde. ## Nieuwkomer-test — het platte antwoord **Nee, een nieuwkomer haalt dit niet zonder uitleg.** Hij vindt de knop met moeite, raadt de bediening, en kon zijn fout niet meer weg krijgen. Dat laatste is nu gerepareerd; de instap niet. Wat wél meteen werkte: gebied tekenen (slepen, hoekgrepen — eerste keer raak), de live dia-miniatuur die `(A)` in de regel ziet verschijnen, en presenteren met stap-voor-stap. De tester noemde dat laatste "de functie op zijn best". Wat niet: **#1860** — de dialoog vertelt niet wat je moet doen. "Toevoegen" plaatst de markering zelf al op het midden, de instructie vraagt om iets selecteren wat niet selecteerbaar is, en de drie presentatiewijzen doen drie verschillende dingen afhankelijk van wanneer je drukt. Aanvullend **#1861** (bewoording en het beschrijvingsveld dat de halve waarheid vertelt) en **#1862** (Escape verlaat de presentatie niet, terwijl de documentatie zegt van wel). Zie ook #1859, dat hetzelfde scherm uit de code beoordeelt en op dezelfde plekken uitkomt. ## Niet getoetst - **OciWacht op een callout-beschrijving** langs de redactieroute: de privacycontrole staat in deze installatie uit, en die aanzetten is een instelling van de gebruiker. Dat een waarde écht uit de PDF verdwijnt is wel bewezen, via de TLP-route (dia op RED, presentatie op CLEAR: de dia komt niet in de export, en ook niet het persoonsgegeven in de callout-beschrijving). - **Compileren van de `.tex`**: geen TeX op deze machine. De reparatie is getoetst op de gegenereerde preamble, niet op een gecompileerd document. Daarmee is deze poort af. De openstaande punten leven verder in #1859-#1862.
brenno 2026-08-29 22:24:51 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
LibreKAT/Ocideck#1848
No description provided.