blog folder/uri structure, new posts (#65)

* blog folder/uri structure, new posts

* fix markdown and slug

---------

Co-authored-by: Dimitri van Hees <info@dimitrivanhees.com>

Author: Dimitri van Hees

blog/2023-09-20-waarom-design-rules.md …m-zijn-api-design-rules-zo-belangrijk.mdblog/2023-09-20-waarom-design-rules.md renamed to blog/2023/09/20-waarom-zijn-api-design-rules-zo-belangrijk.md blog/2023-09-20-waarom-design-rules.md renamed to blog/2023/09/20-waarom-zijn-api-design-rules-zo-belangrijk.md

@@ -1,8 +1,6 @@
 ---
-slug: waarom-zijn-api-design-rules-zo-belangrijk
 authors: [joost-farla]
 tags: [adr, api-design]
-date: 2023-09-20
 ---
 # Waarom zijn API design rules zo belangrijk?
 
@@ -34,4 +32,4 @@ De API design rules stellen strikte voorwaarden aan het beveiligen van API’s,
 
 ## Conclusie
 
-De API design rules dragen op verschillende vlakken bij aan moderne software ontwikkeling. Wil je weten of jouw API ook voldoet aan de API Design Rules? Voeg dan je API toe op [developer.overheid.nl](https://developer.overheid.nl/apis) en laat (een deel van) de API design rules automatisch valideren!
+De API design rules dragen op verschillende vlakken bij aan moderne software ontwikkeling. Wil je weten of jouw API ook voldoet aan de API Design Rules? Voeg dan je API toe op [developer.overheid.nl](https://developer.overheid.nl/apis) en laat (een deel van) de API design rules automatisch valideren!

…og/2023-11-28-uitdagingen-orkestratie.md …28-de-uitdagingen-bij-api-orkestratie.mdblog/2023-11-28-uitdagingen-orkestratie.md renamed to blog/2023/11/28-de-uitdagingen-bij-api-orkestratie.md blog/2023-11-28-uitdagingen-orkestratie.md renamed to blog/2023/11/28-de-uitdagingen-bij-api-orkestratie.md

@@ -1,8 +1,6 @@
 ---
-slug: de-uitdagingen-bij-api-orkestratie
 authors: [joost-farla]
 tags: [adr, orkestratie]
-date: 2023-11-28
 ---
 # De uitdagingen bij API orkestratie
 
@@ -38,4 +36,4 @@ Wanneer gegevens met elkaar worden gecombineerd, is voor de gebruiker niet altij
 
 ## Conclusie
 
-In dit artikel zijn een aantal uitdagingen beschreven die spelen wanneer API orkestratie wordt toegepast. De komende tijd zullen we binnen dit thema meer artikelen publiceren en daarbij per onderwerp dieper ingaan op de details en mogelijke oplossingen en best practices. Ook vinden er momenteel [beproevingen plaats op het Digilab](https://digilab.overheid.nl/projecten/imx-modelgedreven-orkestratie/) rondom het onderwerp orkestratie, in het kader van het toekomstig Federatief Data Stelsel (FDS).
+In dit artikel zijn een aantal uitdagingen beschreven die spelen wanneer API orkestratie wordt toegepast. De komende tijd zullen we binnen dit thema meer artikelen publiceren en daarbij per onderwerp dieper ingaan op de details en mogelijke oplossingen en best practices. Ook vinden er momenteel [beproevingen plaats op het Digilab](https://digilab.overheid.nl/projecten/imx-modelgedreven-orkestratie/) rondom het onderwerp orkestratie, in het kader van het toekomstig Federatief Data Stelsel (FDS).

blog/2024/01/16-fieldlab-samen-naar-een-nieuwe-architectuur.md

@@ -0,0 +1,36 @@
+---
+authors: [digilab]
+tags: []
+---
+# Fieldlab: samen naar een nieuwe architectuur
+
+Op maandag 15 januari 2024 ging het fieldlab Innovatieve Gegevensuitwisseling van start. Het Directoraat Generaal Migratieketen (DGM) van het Ministerie van Justitie en Veiligheid organiseert dit evenement samen met Digilab, de innovatiewerkplaats van het Federatief Datastelsel. In totaal 14 teams gaan samen drie dagen aan de slag om elk vanuit hun eigen perspectief een bijdrage te leveren aan die belangrijke vraagstukken rondom gegevensuitwisseling in dit domein. Het doel: de toekomstige informatiearchitectuur beproeven.
+
+<!-- truncate -->
+
+## Speerpunten
+
+Het ministerie van JenV heeft de afgelopen tijd gewerkt aan een architectuur om alle partners in de migratieketen de komende 10 jaar optimaal te faciliteren in samenwerking én gegevensuitwisseling. Nu deze architectuur klaar is, is de tijd gekomen om samen met de partners te kijken naar de realisatie ervan. Er moeten oplossingen gevonden worden voor verschillende vraagstukken, en een fieldlab is daar een effectieve methode voor. Tijdens het evenement richten deelnemers zich op drie speerpunten:
+
+1. Verschillende databases in één keer gecombineerd bevragen
+2. Gegevens inzien met inachtneming van privacywetgeving
+3. Ketenbreed realtime notificeren
+
+'Die drie processen spelen natuurlijk in de bestaande keten ook al. Digilab helpt de deelnemers om bij het realiseren van onderdelen van de nieuwe architectuur innovatieve technieken en toekomstige standaarden toe te passen die we ook inzetten voor het Federatief Datastelsel.', legt Roos de Groot (product owner Digilab) uit.
+
+Deelnemende organisaties zoals IND, COA en de DT&V hebben elk een multidisciplinair team afgevaardigd. Ontwikkelaars, architecten en alles ertussenin: iedereen werkt binnen, maar ook buiten het team samen aan oplossingen op het gebied van deze speerpunten.
+
+## Hoe dan?
+
+'De nieuwe architectuur van de Migratieketen  MIRA zet een nieuwe stip op de horizon voor de vernieuwing in de keten.', vertelt Peter Mostert, CIO van het DGM. 'Maar nu is de vraag: hoe dan? De migratieketen is behoorlijk complex, en omvat verschillende partners binnen én buiten ons eigen departement, zoals de Koninklijke Marechaussee en Buitenlandse Zaken. Daardoor zijn er behoorlijk wat uitdagingen in de realisatie van deze nieuwe manier om gegevens uit te wisselen. Voor het bedenken van slimme oplossingen zoeken we dan ook actief de hulp van onze ketenpartners en willen we samen leren. Dat we voor dit fieldlab ook nog de hulp hebben van Digilab, daar ben ik erg blij mee.'
+
+## Werkwijze
+
+Tijdens het fieldlab gaan de teams gedurende drie dagen aan de slag met deze vraagstukken. De uitkomsten en oplossingen worden op de derde dag gepresenteerd in een slotbijeenkomst. 'Dit is slechts één van de interventies waar we mee bezig zijn.”, voegt Peter toe. “En als het aan mij ligt gaan we deze werkwijze vaker toepassen.'
+
+- - -
+
+*Nieuwsgierig naar de resultaten, of wil je gewoon meer weten over Digilab? Neem [contact](https://digilab.overheid.nl/contact/) op of log met je Pleio-account in bij onze [online community](https://digilab.overheid.nl/chat/).*
+
+:::note[Dit artikel verscheen eerder op [digilab.overheid.nl](https://digilab.overheid.nl/blog/fieldlab-samen-naar-een-nieuwe-architectuur/)]
+:::

…/2024-02-05-de-kracht-van-open-source.md …/2024/02/05-de-kracht-van-open-source.mdblog/2024-02-05-de-kracht-van-open-source.md renamed to blog/2024/02/05-de-kracht-van-open-source.md blog/2024-02-05-de-kracht-van-open-source.md renamed to blog/2024/02/05-de-kracht-van-open-source.md

@@ -1,34 +1,39 @@
 ---
-slug: de-kracht-van-open-source-hoe-jij-als-developer-beleidsmensen-overtuigt-van-open-source-werken
 authors: [tom-ootes, opensourcewerken]
 tags: [open-source]
-date: 2024-02-05
 ---
 # De kracht van Open Source: hoe jij als developer beleidsmensen overtuigt van Open Source werken
 
 Waarom zou je als developer open source werken? Open source software heeft voordelen voor jou en de organisatie waarvoor je werkt. Daarnaast is open-source sinds 2020 verankerd in de wet. Software die de overheid maakt (of laat maken) moet zo veel mogelijk open source zijn, dit is vastgelegd in de beleidslijn[ 'Open, tenzij'](https://www.digitaleoverheid.nl/document/kamerbrief-over-vrijgeven-broncode-overheidssoftware/). Dit betekent dat overheidsorganisaties verplicht zijn hun software open source te maken, tenzij ze goede redenen hebben om dit niet te doen. Het is dus gewoon verplicht. Maar wat zijn redenen om het als developer daarnaast zelf te willen? En hoe overtuig je de mensen om je heen? Dit is deel 1 uit een reeks van 2 artikelen.
 
 <!-- truncate -->
 
-### ✅ Waarborging onafhankelijkheid organisatie
+## Waarborging onafhankelijkheid organisatie
+
 Door gebruik te maken van open source software voorkom je dat je organisatie afhankelijk wordt van één leverancier, omdat het geld is geïnvesteerd in het bouwen van een gesloten platform. Je voorkomt dat je in de houdgreep van een zogenaamde "vendor lock-in" belandt. Dat betekent dat je als organisatie zo afhankelijk bent geworden van een leverancier dat het niet mogelijk is over te stappen zonder dat verstrekkende financiële gevolgen heeft. Het is dan niet mogelijk om over te stappen omdat het systeem niet kan bestaan buiten de context van het gesloten systeem waar het ooit in is gebouwd. Als de organisatie tóch ooit over wil op open source, dan dient het hele systeem opnieuw gebouwd te worden. De kosten van zo'n migratie zijn dus erg hoog, hier zal een organisatie niet snel voor kiezen.
 
-### ✅ Software is gestold beleid
+## Software is gestold beleid
+
 Overheidssoftware komt voort uit de wetten en regels van diezelfde overheid. Eigenlijk kan de software gezien worden als een soort 'gestold' beleid. Daarmee wordt bedoeld dat de software die wij bouwen invloed heeft op de dagelijkse werkelijkheid van burgers en ambtenaren. Soms kan een stuk software een enorme invloed hebben op het leven van een individu of burger. Denk bijvoorbeeld aan het toeslagenschandaal waarbij de software niet rechtvaardig was. Open source software is inzichtelijk voor journalisten en burgeronderzoekers en daardoor is de kans kleiner dat een dergelijke ramp onopgemerkt blijft. 
 
-### ✅ Geen licentiekosten
+## Geen licentiekosten
+
 Wanneer een leverancier eenmaal de situatie van een vendor lock-in heeft bereikt kan deze de licentiekosten eenzijdig bepalen. De afnemer kan ten slotte toch niet weglopen want deze is afhankelijke van de software die nu onderdeel is van haar dagelijkse processen. Bij open source software heb je geen licentiekosten. Wel komen er natuurlijk kosten kijken bij het opzetten van een open source project. Bijvoorbeeld doordat je extern advies in moet winnen. Maar dit is bij gesloten software niet anders.
 
-### ✅ Betere levensduur en duurzaamheid
+## Betere levensduur en duurzaamheid
+
 Een breed gedragen open source project is niet afhankelijk van de ondersteuning van één leverancier. Zelfs als een bepaalde maintainer aan de wieg van de ontwikkeling van een project staat, kan de community dit nog overpakken. Hiermee wordt de levensduur van een project gewaarborgd, onafhankelijk van de oorspronkelijke leverancier. Een voorbeeld hiervan zien we bij X, dat voorheen nog Twitter heette. Sinds Elon Musk bepaalde dat tweets niet meer voor iedereen zichtbaar zijn, kunnen de Nederlandse hulpdiensten [hier niet meer op vertrouwen](https://tweakers.net/nieuws/211770/meeste-veiligheidsregios-stoppen-met-verwijzingen-naar-twitter-in-nl-alerts.html).
 
-### ✅ Kennisdeling
+## Kennisdeling
+
 Nog een voordeel aan open source werken is dat het uitnodigt tot samenwerking en kennisdeling. Het creëert een cultuur waarbij mensen elkaar opzoeken als ze een vraag hebben over specialistische techniek. Ook bespaart het een hoop geld omdat er gezamenlijk geïnvesteerd wordt in een product dat iedereen kan gebruiken. Zo kunnen organisaties hun krachten bundelen. Een mooi voorbeeld hiervan is [NL Design System](https://nldesignsystem.nl/). Binnen dit project werken verschillende organisaties onder andere samen aan web components (zoals buttons, formulieren en alerts) die uiteindelijk iedereen binnen de overheid kan gebruiken. Overheidswebsites dienen in grote mate toegankelijk te zijn voor mensen met bijvoorbeeld screenreaders. Door samen te werken aan web components van hoge kwaliteit voldoen deze componenten aan alle toegankelijkheids-eisen, en wordt er een hoop tijd bespaard. Ook scoren deze web-components direct erg goed op gebruiksvriendelijkheid.
 
 ## Meedoen
+
 Ken jij andere open source projecten waar anderen van moeten weten? Of zie jij nog meer voordelen of nadelen van open source werken binnen organisaties? Reageer dan hieronder!
 
-Zijn er specifieke vragen of ideeën die je hebt over open source software en wil je hierover met anderen in gesprek? Maak dan een topic aan in ons [ Ideeën & Feature Requests ](https://community.developer.overheid.nl/c/ideeen-feature-requests/22)kanaal.
+Zijn er specifieke vragen of ideeën die je hebt over open source software en wil je hierover met anderen in gesprek? Maak dan een topic aan in ons [Ideeën & Feature Requests](https://community.developer.overheid.nl/c/ideeen-feature-requests/22) kanaal.
 
 ## Wordt vervolgd
-Stay tuned! Er zal een tweede deel van deze blog verschijnen over de voordelen van open source software. Daarin gaan we in op de meer technische redenen die er zijn om voor open source software te kiezen.
+
+Stay tuned! Er zal een tweede deel van deze blog verschijnen over de voordelen van open source software. Daarin gaan we in op de meer technische redenen die er zijn om voor open source software te kiezen.

…og/2024-03-27-design-first-code-first.md …og/2024/03/27-design-first-code-first.mdblog/2024-03-27-design-first-code-first.md renamed to blog/2024/03/27-design-first-code-first.md blog/2024-03-27-design-first-code-first.md renamed to blog/2024/03/27-design-first-code-first.md

@@ -1,8 +1,6 @@
 ---
-slug: design-first-of-code-first-api-ontwikkeling
 authors: [joost-farla]
 tags: [openapi, adr, api-design]
-date: 2024-03-27
 ---
 # Design-first of code-first API ontwikkeling?
 
@@ -42,4 +40,4 @@ Uiteindelijk komt de compleetheid en nauwkeurigheid van de API specificatie ten
 
 ## Samengevat
 
-Design-first legt de nadruk op het vooraf definiëren van het API ontwerp voordat de implementatie begint, terwijl code-first begint met het bouwen van de functionaliteit en het ontwerp ontstaat tijdens het ontwikkelingsproces. De design-first aanpak voorkomt een implementatie-specifiek API ontwerp, kan helpen in het stroomlijnen van het ontwikkelproces en levert een positieve bijdrage aan de kwaliteit van API documentatie.
+Design-first legt de nadruk op het vooraf definiëren van het API ontwerp voordat de implementatie begint, terwijl code-first begint met het bouwen van de functionaliteit en het ontwerp ontstaat tijdens het ontwikkelingsproces. De design-first aanpak voorkomt een implementatie-specifiek API ontwerp, kan helpen in het stroomlijnen van het ontwikkelproces en levert een positieve bijdrage aan de kwaliteit van API documentatie.

blog/2024-06-19-azure-ipv6-proxy.md …06/19-generieke-ipv6-proxy-voor-azure.mdblog/2024-06-19-azure-ipv6-proxy.md renamed to blog/2024/06/19-generieke-ipv6-proxy-voor-azure.md blog/2024-06-19-azure-ipv6-proxy.md renamed to blog/2024/06/19-generieke-ipv6-proxy-voor-azure.md

@@ -1,8 +1,6 @@
 ---
-slug: generieke-ipv6-proxy-voor-azure
 authors: [digilab]
 tags: [kubernetes, azure, ipv6, infra]
-date: 2024-06-19
 ---
 # Generieke IPv6 proxy voor Azure
 
@@ -18,8 +16,7 @@ Als je een website bezoekt, wordt er op de achtergrond een IP-adres opgezocht da
 
 De Terraform-module zet een virtuele machine op die zowel IPv4 als IPv6 ondersteunt. De machine krijgt een publiek bereikbaar IPv6-adres. Je kunt dit adres gebruiken voor het IPv6 `AAAA` DNS-record. De machine ontvangt een IPv6-request en maakt vervolgens via IPv4 een request naar de IPv4-bestemming. Aangezien de machine aan TLS-passthrough doet is de machine niet in staat om het verkeer te inspecteren.
 
-![ipv6-proxy|390x500](upload://zlBB1nh1w4zmPLF5QuWO5LvQU6n.png)
-
+![ipv6-proxy|390x500](ipv6-proxy.png)
 
 Op deze manier is je website beschikbaar via IPv6, zonder dat je aanpassingen hoeft te doen aan je bestaande (IPv4-only) infrastructuur.
 
@@ -40,6 +37,7 @@ module "ipv6_proxy" {
 De module ondersteunt het ook gelijk een `AAAA` DNS-record aan te maken voor het IPv6-adres dat de proxy toegewezen heeft gekregen. Zie de voorbeelden in de repository van de module om te kijken hoe dat werkt.
 
 ## Limitaties
+
 - doordat er een enkele virtuele machine wordt gebruikt, creëer je een Single Point of Failure.
 - doordat er een enkele virtuele machine wordt gebruikt, is de oplossing niet schaalbaar.
 - door de TLS-passthrough (en geen ondersteuning voor SNI), kun je geen backend selecteren op basis van de hostname / domeinnaam. Al het verkeer gaat naar dezelfde bestemming, en pas daar kan het onderscheid gemaakt worden.
@@ -48,4 +46,7 @@ De module ondersteunt het ook gelijk een `AAAA` DNS-record aan te maken voor het
 
 - - -
 
-*Wil je gewoon meer weten over Digilab? Neem [contact](https://digilab.overheid.nl/contact/) op of log met je Pleio-account in bij onze [online community](https://digilab.overheid.nl/chat/).*
+*Wil je gewoon meer weten over Digilab? Neem [contact](https://digilab.overheid.nl/contact/) op of log met je Pleio-account in bij onze [online community](https://digilab.overheid.nl/chat/).*
+
+:::note[Dit artikel verscheen eerder op [digilab.overheid.nl](https://digilab.overheid.nl/blog/azure-generieke-ipv6-proxy/)]
+:::

blog/2024/06/ipv6-proxy.png

@@ -0,0 +1,34 @@
+---
+authors: [digilab]
+tags: []
+---
+# Dag van de Toekomstige Registraties
+
+Op 25 juni 2024 organiseerde Digilab de Dag van de Toekomstige Registraties. We hebben samen verkend hoe we voor de toekomst registers kunnen bouwen die voldoen aan publieke waarden, die wendbaar zijn en een traceerbare vertaling van wet naar uitvoering borgen.
+
+<!-- truncate -->
+
+Een speciaal dankwoord gaat uit naar onze sprekers:
+
+**Arjan Widlak**, die ons meenam in de historie van de bureaucratie en waar het in de digitalisering soms scheef loopt. Waar burgers klem komen te zitten, als vissen wel worden meegesleurd in een waterval van gegevensdeling, maar diezelfde vissen niet meer stroomopwaarts kunnen zwemmen als het nodig is.
+
+**Mariette Lokin**, warm pleitbezorger van een Weberiaanse bureaucratie in de goede zin des woords, gaf een doorkijkje naar de methode Wendbare Wetsanalyse en de voordelen van juridisch-technische samenwerking naar het voorbeeld van Devops: “Legops”. Want uiteindelijk ís de wet een algoritme. Tijd om dat in onze register-ontwerpen mee te nemen.
+
+**Wicher Minnaard** verplaatste ons naar een heel andere context, waar hij greenfield met een klein team in zes maanden een nieuwe overheidsregistratie neerzette: in Timor-Leste. Hij liet overtuigend zien waarom je als overheid geen genoegen wil nemen met een tabel met huidige states, waarom je altijd terug wil kunnen kijken en rekenen. En waarom het belangrijk is om in je ontwerp te erkennen dat je registratie de werkelijkheid benadert. En dat je de best mogelijke benadering met nieuwe inzichten wilt kunnen updaten, zónder de geschiedenis te wissen.
+
+**Jeanot Bijpost** bouwde voort op de verhalen van zijn voorgangers door te laten zien hoe we dan het liefste de werkelijkheid benaderen in een toekomstige registratie. Dat het daarvoor handig is als claims over die werkelijkheid opgedeeld zijn in delen, die je op afzonderlijke tijdsassen kunt beschrijven en oproepen. Als we lezen en schrijven niet hetzelfde behandelen, en we bij onze registratiehandelingen ook de context meegeven waarom deze handeling is verricht. Geeft dat niet allerhande praktische bezwaren? Is dat altijd nodig? Op deze en andere vragen richt het Digilab-onderzoeksproject Uit Betrouwbare Bron zich de komende jaren.
+
+Vervolgens gingen we de diepte in met Mariette Lokin en Eelco Hotting in de Wendbare Wetsanalyse, en met Marc van Andel en Jeanot Bijpost in de voors, tegens en uitdagingen van claimsourcing als ontwerpprincipe voor toekomstige registraties.
+
+Wil je nog even rustig nalezen wat er langs is gekomen? Dat kan: de presentaties staan in onze chatomgeving [digilab.overheid.nl/chat](https://digilab.overheid.nl/chat). Mocht je nog geen lid zijn, meld je dan aan met je Pleio-account.
+
+We plaatsen hier ook een korte vragenlijst om jullie feedback op te halen en te peilen hoe we samen met jullie deze toekomstige registraties dichterbij kunnen brengen. Ook horen we graag welke onderwerpen jullie aanspreken voor toekomstige events.
+
+Voel je tevens vrij om rechtstreeks contact op te nemen met ons. Ook dat kan via onze chatomgeving, met een direct bericht aan een van onze teamleden.
+
+Graag tot ziens bij Digilab!
+
+::video-vimeo[sfeerimpressie]{id=981808944}
+
+:::note[Dit artikel verscheen eerder op [digilab.overheid.nl](https://digilab.overheid.nl/blog/dag-van-de-toekomstige-registraties/)]
+:::