TLP vraagt voor wie het is, met een standaarduitleg in het bestand

brenno commented

2026-10-12 11:52:57 +00:00

Owner

Wat je wilt

Als je een TLP zet, hoort daar bij voor wie het is — zeker bij TLP:AMBER+STRICT en TLP:RED. In het document verwacht je een stukje uitleg, optioneel aan te vullen. Hetzelfde bij een presentatie, desnoods als extra dia. Daarnaast hoort er een vaste standaarduitleg te zijn, zodat de markering niet alleen een badge is.

Wat de code nu doet

TLP is één niveau en verder niets. De sleutel is tlp: met de FIRST-waarden clear, green, amber, amber+strict, red (TlpLevel in lib/models/deck.dart, FILE_FORMAT §3.1).

Op een document geldt dat niveau voor het hele bestand (MarkdownDocument.tlp). De editor zet het via het TLP-menu (_tlpMenu in lib/widgets/parts/document_editor_toolbar.dart) en withTlp schrijft alleen die ene regel. Zichtbaar wordt het als het label TLP:AMBER+STRICT in kop- en voetband (DocumentChromeBand in lib/widgets/document_page_chrome.dart) en in de export. Er is geen veld “voor wie”, geen alinea in de tekst, en geen standaardzin.

Op een presentatie is het hetzelfde niveau, deck-breed plus een optionele per-dia-markering (). De statusbalk en het watermerk tonen het label. Er is geen uitlegdia.

De band verschijnt alleen als er een classificatie of stijlband is (_hasDocumentChrome). De betekenis van het niveau — niet verder delen, alleen de eigen organisatie, alleen deze ontvangers — staat nergens in het bestand dat de ontvanger krijgt.

Oplossingsrichting

Het niveau blijft tlp:. De uitleg hoort in de tekst die de ontvanger leest, niet in een badge die alleen OciDeck tekent.

Bij het kiezen van een niveau, vóór het schrijven:

TLP:AMBER+STRICT en TLP:RED vragen voor wie het is. Zonder dat antwoord wordt het niveau niet gezet. CLEAR en GREEN mogen de standaardzin zonder ontvangerslijst.
De dialoog toont de standaarduitleg van dát niveau: de FIRST-deelregel in het kort (RED niet verder dan deze uitwisseling, AMBER+STRICT alleen de eigen organisatie, AMBER ook cliënten van die organisatie, GREEN de community, CLEAR ongelimiteerd). De officiële markering blijft de bron; verzin geen eigen schaal.
Optioneel een eigen zin erbij. Die is van de gebruiker.

Wegschrijven:

Document: een gewone alinea (of blokcitaat) direct onder de titel, met de standaardzin, de ontvangers en de optionele eigen zin. Na het invoegen is het gewone tekst: de gebruiker kan hem schrappen of herschrijven, en opslaan raakt hem daarna niet meer aan. Het niveau in de front matter en de badge blijven, ook als de alinea weg is. Geen HTML-commentaar als anker en geen ocideck_-sleutel om hem later stil te vervangen.
Presentatie: dezelfde dialoog, met de keuze om er een gewone dia van te maken (titel plus de tekst, bestaand type vrije tekst of bullets). Geen nieuw slidetype. De dia is inhoud, geen overlay. Per-dia-TLP blijft wat hij is; deze dia legt het deck-niveau uit.

“Voor wie” kan een naam zijn. Dat is tekst in het bestand dat de gebruiker zelf opslaat. OciWacht scant hem zoals elke andere alinea. Niet loggen, niet apart versturen.

De dialoogteksten zijn interface (alle talen). De alinea die in het bestand belandt is inhoud: schrijf hem in de taal van de interface op het moment van invoegen, vanuit vertaalde zinnen, en daarna niet meer nasynchroniseren.

Bestandsformaat

Geen nieuwe sleutel. tlp: blijft het niveau. De uitleg is Markdown-body of een gewone dia, zodat een andere editor hem zonder OciDeck leest. Een ontvangersveld alleen in de front matter is niet genoeg: dan ziet de ontvanger de badge wel en de zin niet.

Test

AMBER+STRICT zonder ontvangers schrijft geen tlp: en geen alinea.
Met ontvangers en een eigen zin staat het niveau in de front matter, de badge op de band, en de drie delen (standaard, ontvangers, eigen zin) in de body. Een tweede opslaan zonder de alinea te wijzigen verdubbelt hem niet.
De alinea verwijderen laat tlp: staan.
Presentatie: “als dia” voegt één dia toe en verandert de andere dia’s niet. Het zegel van een afgerond deck blijft het bestaande pad volgen (niet stil een dia invoegen in een verzegeld deck).

Kosten

Nieuwe dialoogteksten én de standaardzinnen (31 talen). FILE_FORMAT §3.1 en de handleiding: de uitleg is inhoud, de sleutel blijft tlp:. Geen nieuw slidetype, geen afhankelijkheid.

## Wat je wilt Als je een TLP zet, hoort daar bij voor wie het is — zeker bij TLP:AMBER+STRICT en TLP:RED. In het document verwacht je een stukje uitleg, optioneel aan te vullen. Hetzelfde bij een presentatie, desnoods als extra dia. Daarnaast hoort er een vaste standaarduitleg te zijn, zodat de markering niet alleen een badge is. ## Wat de code nu doet TLP is één niveau en verder niets. De sleutel is `tlp:` met de FIRST-waarden `clear`, `green`, `amber`, `amber+strict`, `red` (`TlpLevel` in `lib/models/deck.dart`, FILE_FORMAT §3.1). Op een document geldt dat niveau voor het hele bestand (`MarkdownDocument.tlp`). De editor zet het via het TLP-menu (`_tlpMenu` in `lib/widgets/parts/document_editor_toolbar.dart`) en `withTlp` schrijft alleen die ene regel. Zichtbaar wordt het als het label `TLP:AMBER+STRICT` in kop- en voetband (`DocumentChromeBand` in `lib/widgets/document_page_chrome.dart`) en in de export. Er is geen veld “voor wie”, geen alinea in de tekst, en geen standaardzin. Op een presentatie is het hetzelfde niveau, deck-breed plus een optionele per-dia-markering (``). De statusbalk en het watermerk tonen het label. Er is geen uitlegdia. De band verschijnt alleen als er een classificatie of stijlband is (`_hasDocumentChrome`). De betekenis van het niveau — niet verder delen, alleen de eigen organisatie, alleen deze ontvangers — staat nergens in het bestand dat de ontvanger krijgt. ## Oplossingsrichting Het niveau blijft `tlp:`. De uitleg hoort in de tekst die de ontvanger leest, niet in een badge die alleen OciDeck tekent. Bij het kiezen van een niveau, vóór het schrijven: - TLP:AMBER+STRICT en TLP:RED vragen voor wie het is. Zonder dat antwoord wordt het niveau niet gezet. CLEAR en GREEN mogen de standaardzin zonder ontvangerslijst. - De dialoog toont de standaarduitleg van dát niveau: de FIRST-deelregel in het kort (RED niet verder dan deze uitwisseling, AMBER+STRICT alleen de eigen organisatie, AMBER ook cliënten van die organisatie, GREEN de community, CLEAR ongelimiteerd). De officiële markering blijft de bron; verzin geen eigen schaal. - Optioneel een eigen zin erbij. Die is van de gebruiker. Wegschrijven: - Document: een gewone alinea (of blokcitaat) direct onder de titel, met de standaardzin, de ontvangers en de optionele eigen zin. Na het invoegen is het gewone tekst: de gebruiker kan hem schrappen of herschrijven, en opslaan raakt hem daarna niet meer aan. Het niveau in de front matter en de badge blijven, ook als de alinea weg is. Geen HTML-commentaar als anker en geen `ocideck_`-sleutel om hem later stil te vervangen. - Presentatie: dezelfde dialoog, met de keuze om er een gewone dia van te maken (titel plus de tekst, bestaand type vrije tekst of bullets). Geen nieuw slidetype. De dia is inhoud, geen overlay. Per-dia-TLP blijft wat hij is; deze dia legt het deck-niveau uit. “Voor wie” kan een naam zijn. Dat is tekst in het bestand dat de gebruiker zelf opslaat. OciWacht scant hem zoals elke andere alinea. Niet loggen, niet apart versturen. De dialoogteksten zijn interface (alle talen). De alinea die in het bestand belandt is inhoud: schrijf hem in de taal van de interface op het moment van invoegen, vanuit vertaalde zinnen, en daarna niet meer nasynchroniseren. ## Bestandsformaat Geen nieuwe sleutel. `tlp:` blijft het niveau. De uitleg is Markdown-body of een gewone dia, zodat een andere editor hem zonder OciDeck leest. Een ontvangersveld alleen in de front matter is niet genoeg: dan ziet de ontvanger de badge wel en de zin niet. ## Test - AMBER+STRICT zonder ontvangers schrijft geen `tlp:` en geen alinea. - Met ontvangers en een eigen zin staat het niveau in de front matter, de badge op de band, en de drie delen (standaard, ontvangers, eigen zin) in de body. Een tweede opslaan zonder de alinea te wijzigen verdubbelt hem niet. - De alinea verwijderen laat `tlp:` staan. - Presentatie: “als dia” voegt één dia toe en verandert de andere dia’s niet. Het zegel van een afgerond deck blijft het bestaande pad volgen (niet stil een dia invoegen in een verzegeld deck). ## Kosten Nieuwe dialoogteksten én de standaardzinnen (31 talen). FILE_FORMAT §3.1 en de handleiding: de uitleg is inhoud, de sleutel blijft `tlp:`. Geen nieuw slidetype, geen afhankelijkheid.

brenno added the

enhancement

in-progress

labels

2026-10-12 11:52:57 +00:00

brenno commented

2026-10-12 11:57:55 +00:00

Author

Owner

Opgepakt. Tak: fix/document-werkvloer. Verwachte reikwijdte: lib/widgets/parts/document_editor_toolbar.dart, lib/widgets/document_editor_screen.dart, lib/models/deck.dart, lib/widgets/dialogs/presentation_info_dialog.dart, docs/FILE_FORMAT.md.

brenno referenced this issue from a commit

2026-10-12 14:12:03 +00:00

Maak de documentmodus bruikbaar op de werkvloer (#2394 #2395 #2396 #2397 #2398).

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

2026-10-12 14:12:23 +00:00

Maak de documentmodus bruikbaar op de werkvloer #2401

brenno closed this issue

2026-10-12 14:17:31 +00:00

brenno commented

2026-10-12 14:18:17 +00:00

Author

Owner

Geland op main in 597353b59, via PR #2401.

ZAP/DAST is niet gedraaid: ZAP is niet geïnstalleerd. Geheimen-scan en SAST zijn lokaal wel gedraaid, vóór de merge.

Geland op main in 597353b59, via PR #2401. ZAP/DAST is niet gedraaid: ZAP is niet geïnstalleerd. Geheimen-scan en SAST zijn lokaal wel gedraaid, vóór de merge.

Rows
Columns

TLP vraagt voor wie het is, met een standaarduitleg in het bestand #2396

Wat je wilt

Wat de code nu doet

Oplossingsrichting

Bestandsformaat

Test

Kosten