Verrijken van Logius landingspagina voor CloudEvents

[sanderke]

Waarom

Stas:

Na enige zelfreflectie en commentaar van buiten is het ons duidelijk dat er nog behoorlijk veel content mist/matig is beschreven op de logius site.
Specifiek voor CE is er een hoop informatie verzameld door @adgerrits in een van de voorgangerprojecten. Een hoop daarvan is te vinden op de Gemma themaarchitectuur 1, 2, CloudEvents en deze github repo (TODO: link)

Martin vd Plas heeft ook veel verzameld en toegevoegd aan KP API github omdat daar de WG Notificeren wordt gehost.

Bovendien is er nog een blog post (WIP) bij Developer Overheid geschreven door Martin en gereviewed door mij.

Logius landingspagina's verwijzing URL veranderen naar: https://gitdocumentatie.logius.nl/publicatie/notificatieservices/cloudevents-nl/

Acceptatiecriteria

• De content voor de Logius site is herschreven
• nieuwe stukken zijn aangeleverd bij de webcommisie/communicatie collega's
• de wijziging zijn doorgevoerd en gereviewd door de buitenwereld

[sanderke]

Tekst van @Nil-NMB01 (bijgewerkt):

Wat is het NL GOV Profile for CloudEvents?

Hoofdinhoud

Overheidsorganisaties hebben een groeiende behoefte aan actuele informatie uit basisregistraties. Deze gegevens veranderen vaak, bijvoorbeeld door verhuizingen of overlijdens. Het NL GOV Profile for CloudEvents beschrijft een gestandaardiseerde manier om dit soort gebeurtenissen uit te wisselen.

Wat is CloudEvents?

CloudEvents is een open standaard voor het beschrijven van gebeurtenisgegevens. Deze standaard bevordert de interoperabiliteit tussen verschillende diensten en platforms door informatie over gebeurtenissen op een uniforme manier uit te wisselen.

Zo wordt het eenvoudiger voor systemen om op gebeurtenissen te reageren en samen te werken in event-driven omgevingen.

Het nut van de standaard

Het NL GOV Profile for CloudEvents is ontwikkeld voor gebruik binnen de Nederlandse overheid. Het profiel voegt specifieke afspraken toe aan de internationale CloudEvents-specificatie die relevant zijn voor overheidsorganisaties.

Het profiel wordt ook wel een notificatiestandaard genoemd: organisaties die zich eraan houden, kunnen hun systemen zo inrichten dat ze elkaar automatisch informeren over gebeurtenissen, zoals een verhuizing van een burger.

Dit zorgt niet alleen voor snellere communicatie, maar ook voor beter gegevensbeheer. Informatie kan bij de bron worden onderhouden, terwijl afnemers onmiddellijk op de hoogte zijn van relevante veranderingen.

Hoe het werkt

Het NL GOV Profile for CloudEvents beschrijft hoe de internationale CloudEvents-standaard wordt toegepast binnen de Nederlandse context. Het specificeert onder andere welke attributen gebruikt worden en hoe Nederland specifieke afspraken toevoegt aan de internationale standaard.

Raadpleeg de technische documentatie voor meer informatie.

[adgerrits]

Een paar tekstsuggesties:

• "behoefte aan actuele informatie vanuit de basisregistraties" Waarom (weer) vernauwen tot die paar basisregistraties terwijl er duizenden registraties zijn? Spreek dan gewoon over 'registraties'.
• "Zo weet bijvoorbeeld een gemeente direct dat een van hun inwoners verhuist." Slecht voorbeeld want gemeenten houden zelf bij welke van hun inwoners veranderen. "Zo kunnen overheidsorganisaties snel op de hoogte worden gesteld als een burger waarmee zij contact hebben verhuist".
• "Door elkaar te notificeren kan informatie centraal of bij de bron beheerd worden." Dat kan/gebeurt ook zonder notificeren. Waarschijnlijk wordt bedoeld dat afnemers gegevens die centraal worden beheerd in sommige gevallen niet meer zelf hoeven vast te leggen. Let wel: in sommige gevallen want het in veel gevallen zal lokale vastlegging nodig blijven.
• " Vervolgens beschrijft het hoe die gegevens via API's razendsnel uitgewisseld kan worden." - API's zijn een manier, maar zeker niet de enige manier. Je kunt ook van de standaard gebruik maken via bijv. messaging of bestandsuitwisseling.

[adgerrits]

Wordt het geen tijd de website-pagina aan te passen? Sowieso zou ik op die pagina wat meer nieuws plaatsen. Vanaf een afstand bezien gebeurt er genoeg met de standaard en zaken daaromheen (bijv. werkgroep, abonneren, use cases). Wat vaker nieuws zorgt ervoor dat mensen te weten komen dat er actief aan en mee gewerkt wordt. Iets waar binnen de overheid vaak te weinig oog voor is maar ‘marketing en communicatie’ bepaalt tegenwoordig in belangrijke mate of iets een succes wordt.

[TheBonheurs]

TODO @TheBonheurs - maak aanzet tot eerste blog post incl. laatste nieuws rondom dit onderwerp.
Wel in aparte issue.

@adgerrits dez gaat zsm afgerond worden, werd zeker tijd!

[TheBonheurs]

13/4/2026 @sanderke updaten van tekst op acceptatieomgeving