Run sync script and add link handling function (#89)

measures/0-org-02-beleid_opstellen_inzet_algoritmes.yaml → measures/0-org-02-beleid-opstellen-inzet-algoritmes.yaml

@@ -19,25 +19,25 @@ explanation: "Een duidelijk beleid over de inzet van algoritmes helpt organisati
   \ kan worden gedacht aan:\n    - Het [Algoritmeregister](../hulpmiddelen/algoritmeregister.md)\
   \ voor het publiceren van hoog risico AI-systemen of impactvolle algoritmes. \n\
   \    - Een algemene pagina op de website met informatie over de inzet van algoritmes.\n\
-  \    - Het [verwerkingsregister](6-imp-08-vermelding-in-verwerkingsregister.md).\n\
+  \    - Het [verwerkingsregister](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/6-imp-08-vermelding-in-verwerkingsregister/index.html).\n\
   \    - Een intern registratiesysteem, bijvoorbeeld voor het registreren van laag\
   \ risico of niet-impactvolle algoritmes zodat deze informatie voor medewerkers beschikbaar\
-  \ is.\n    - In welke gevallen een [(openbaar) besluit](6-imp-09-politiek-bestuurlijk-besluit.md)\
+  \ is.\n    - In welke gevallen een [(openbaar) besluit](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/6-imp-09-politiek-bestuurlijk-besluit/index.html)\
   \ wordt genomen door het bestuur over de inzet van een algoritme. \n\n- Er is beschreven\
   \ welke informatie over welke typen algoritmes wordt gecommuniceerd met betrokkenen\
   \ bij de ontwikkeling of gebruik ervan door de organisatie. \n\n- Er is beschreven\
   \ welke stappen worden gezetten in het geval dat er incidenten ontstaan rondom de\
-  \ inzet van algoritmes, denk hierbij aan een [discriminatieprotocol](0-org-15-discriminatieprotocol.md).\n\
+  \ inzet van algoritmes, denk hierbij aan een [discriminatieprotocol](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/0-org-15-discriminatieprotocol/index.html).\n\
   \n- Dit beleidsdocument is beschikbaar en toegankelijk voor geïnteresseerden. \n"
-urn: urn:nl:ak:mtr:org-04
+urn: urn:nl:ak:mtr:org-02
 language: nl
 owners:
 - organization: Algoritmekader
   name: ''
   email: ''
   role: ''
 date: ''
-url: https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/0-org-02-beleid_opstellen_inzet_algoritmes/index.html
+url: https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/0-org-02-beleid-opstellen-inzet-algoritmes/index.html
 subject:
 - governance
 - transparantie

measures/0-org-03-toepassen_risicobeheer.yaml → measures/0-org-03-toepassen-risicobeheer.yaml

@@ -29,7 +29,7 @@ owners:
   email: ''
   role: ''
 date: ''
-url: https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/0-org-03-toepassen_risicobeheer/index.html
+url: https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/0-org-03-toepassen-risicobeheer/index.html
 subject:
 - governance
 suggested_roles:

measures/0-org-04-politiek-bestuurlijke-verantwoordelijkheid.yaml

@@ -12,16 +12,16 @@ explanation: "- Voor een passende algoritmegovernance is politiek-bestuurlijk be
   \ de mate waarin de inzet van technologie bijdraagt aan de legitimiteit van publieke\
   \ organisatie en hoe burgers met deze technologie worden bejegend. \n- Om te zorgen\
   \ voor politiek-bestuurlijke betrokkenheid kan het helpen om een [meerjarige visie/strategie\
-  \ rondom verantwoorde inzet](0-org-02-beleid_opstellen_inzet_algoritmes.md) te formuleren\
-  \ waar een communicatiestrategie richting burgers onderdeel van is.\n- Zorg ervoor\
-  \ dat bestuurders bewust zijn van de voor- en nadelen van de inzet van algoritmes\
-  \ en daarnaar kunnen handelen.\n- Dit ondersteunt teams bij het maken van de juiste\
-  \ overwegingen bij de ontwikkeling en gebruik van algoritmes. Het geeft ook inzicht\
-  \ wanneer de politiek of bestuurlijk verantwoordelijke(n) moeten worden betrokken\
-  \ bij het project om beslissingen te nemen, bijvoorbeeld of de mate van onbewuste\
-  \ vooringenomenheid (bias) binnen acceptabele grenzen ligt. \n- Het doorlopen van\
-  \ een concrete casus voor de ontwikkeling en gebruik van een algoritme, inclusief\
-  \ het uitvoeren van een IAMA, kan waardevolle informatiegeven om een meerjarige\
+  \ rondom verantwoorde inzet](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/0-org-02-beleid-opstellen-inzet-algoritmes/index.html)\
+  \ te formuleren waar een communicatiestrategie richting burgers onderdeel van is.\n\
+  - Zorg ervoor dat bestuurders bewust zijn van de voor- en nadelen van de inzet van\
+  \ algoritmes en daarnaar kunnen handelen.\n- Dit ondersteunt teams bij het maken\
+  \ van de juiste overwegingen bij de ontwikkeling en gebruik van algoritmes. Het\
+  \ geeft ook inzicht wanneer de politiek of bestuurlijk verantwoordelijke(n) moeten\
+  \ worden betrokken bij het project om beslissingen te nemen, bijvoorbeeld of de\
+  \ mate van onbewuste vooringenomenheid (bias) binnen acceptabele grenzen ligt. \n\
+  - Het doorlopen van een concrete casus voor de ontwikkeling en gebruik van een algoritme,\
+  \ inclusief het uitvoeren van een IAMA, kan waardevolle informatiegeven om een meerjarige\
   \ visie of strategie op te stellen. \n"
 urn: urn:nl:ak:mtr:org-04
 language: nl

measures/0-org-15-discriminatieprotocol.yaml

@@ -14,9 +14,9 @@ explanation: "De inzet van algoritme kan onbedoeld leiden tot discriminerende ef
   Het vaststellen van een dergelijk protocol geeft ontwikkelaar en gebruikers (vooraf)\
   \ duidelijkheid wat van hen wordt verwacht en wat zij kunnen doen om discriminatie\
   \ door algoritmes te voorkomen.  \nEen voorbeeld hiervan is het analyseren van de\
-  \ data op [datakwaliteit en bias in de data](3-dat-01-datakwaliteit.md) en [toets\
-  \ regelmatig je algoritmisch systeem op bias](5-ver-02-biasanalyse.md). \n\nHet\
-  \ Ministerie van Binnenlandse Zaken en Koninkrijksrelaties heeft een [discriminatieprotocol](https://minbzk.github.io/discriminatieprotocol)\
+  \ data op [datakwaliteit en bias in de data](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/3-dat-01-datakwaliteit/index.html)\
+  \ en [toets regelmatig je algoritmisch systeem op bias](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/5-ver-03-biasanalyse/index.html).\
+  \ \n\nHet Ministerie van Binnenlandse Zaken en Koninkrijksrelaties heeft een [discriminatieprotocol](https://minbzk.github.io/discriminatieprotocol)\
   \ opgesteld wat organisaties handvatten biedt.\n\nEen discriminatieprotocol kan\
   \ de volgende stappen bevatten:\n\n### Stap 1: Vermoeden van onrechtmatigheid\n\n\
   Een vermoeden van bevooroordeeldheid of discriminatie kan vanuit verschillende partijen\
@@ -27,7 +27,7 @@ explanation: "De inzet van algoritme kan onbedoeld leiden tot discriminerende ef
   \ er sprake is van zo'n vermoeden, zorg je dat bijvoorbeeld de uitvoerend directeur,\
   \ de interne toezichthouder en/of de CIO en CDO hierover worden geïnformeerd. \n\
   \  - Maak met de verantwoordelijken een afweging of het betreffende systeem in werking\
-  \ kan blijven of dat bijvoorbeeld [het noodplan voor het stopzetten van het algoritme](4-owk-02-stopzetten-gebruik.md)\
+  \ kan blijven of dat bijvoorbeeld [het noodplan voor het stopzetten van het algoritme](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/4-owk-02-stopzetten-gebruik/index.html)\
   \ (tijdelijk) in gang moet worden gezet. \n\n### Stap 2: Inzicht en overzicht\n\n\
   Het is van belang om inzicht en overzicht te krijgen over de oorzaak en de gevolgen\
   \ van eventuele discriminerende effecten van het algoritme. \nDaarvoor kan worden\
@@ -41,7 +41,7 @@ explanation: "De inzet van algoritme kan onbedoeld leiden tot discriminerende ef
   Bepaal welke mitigerende maatregelen er genomen moeten worden. Als er in het onderzoek\
   \ is vastgesteld dat er sprake is van discriminatie, dan moet het betreffende systeem\
   \ worden stopgezet. Hierbij kan je denken aan:\n\n   - Het in werking stellen van\
-  \ het [het noodplan voor het stopzetten van het algoritme](4-owk-02-stopzetten-gebruik.md),\
+  \ het [het noodplan voor het stopzetten van het algoritme](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/4-owk-02-stopzetten-gebruik/index.html),\
   \ indien dat in stap 1 nog niet gebeurd is. \n   - Aanpassingen in het algoritme,\
   \ de werkinstructies of de bijbehorende processen.\n   - Indien het algoritme essentieel\
   \ is in de uitvoer kan er sprake zijn van een een proportionaliteitsvraagstuk. In\
@@ -64,7 +64,7 @@ explanation: "De inzet van algoritme kan onbedoeld leiden tot discriminerende ef
   \n  - Registreer het algoritme in het [algoritmeregister](https://algoritmes.overheid.nl/nl),\
   \ indien dat nog niet gebeurd is.\n  - Zorg voor goede klachtenafhandeling en herstelprocedures.\
   \ \n"
-urn: urn:nl:ak:mtr:imp-10
+urn: urn:nl:ak:mtr:org-15
 language: nl
 owners:
 - organization: Algoritmekader

measures/1-pba-02-formuleren-doelstelling.yaml

@@ -11,7 +11,7 @@ explanation: "- Het doel van de inzet van een algoritme dient zo concreet en spe
   Welke doelen zijn subdoelen, waarvoor het minder belangrijk is om deze te realiseren?\n\
   \n- Indien mogelijk, dienen de doelstellingen gekwantificeerd te worden (SMART).\
   \ \n\n- Om te zorgen voor voldoende draagvlak voor de beoogde doelen, is het noodzaak\
-  \ om [voldoende belanghebbenden te betrekken](1-pba-04-betrek-belanghebbenden.md).\
+  \ om [voldoende belanghebbenden te betrekken](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/1-pba-04-betrek-belanghebbenden/index.html).\
   \ \nHierbij kan het ook helpen om burgers te betrekken bij de totstandkoming van\
   \ de doelstellingen, bijvoorbeeld door middel van een burgerpanel of het betrekken\
   \ van belangengroepen. \n\nHet algoritme dient niet het beoogde doel en onderliggend\

measures/1-pba-03-onderbouwen-gebruik-algoritme.yaml

@@ -7,9 +7,9 @@ explanation: "- Bepaal waarom het gewenst of nodig is om een algoritme in te zet
   \ en of er ook alternatieven zijn om het probleem op te lossen. \nDocumenteer de\
   \ onderbouwing waarom een algoritme een betere oplossing zou bieden dan een niet-geautomatiseerd\
   \ of niet-digitaal proces. \n\n- Maak een bewuste afweging of een algoritme het\
-  \ juiste middel is om [het probleem](1-pba-01-formuleren-probleemdefinitie.md) op\
-  \ doelmatige en doeltreffende wijze op te lossen, en documenteer deze afweging.\n\
-  \n- Beoordeel of de gewenste oplossing is [toegestaan op grond van de AI-Verordening](aia-01-verboden-AI-praktijken.md).\
+  \ juiste middel is om [het probleem](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/1-pba-01-formuleren-probleemdefinitie/index.html)\
+  \ op doelmatige en doeltreffende wijze op te lossen, en documenteer deze afweging.\n\
+  \n- Beoordeel of de gewenste oplossing is [toegestaan op grond van de AI-Verordening](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/vereisten/aia-00-verboden-AI-praktijken/index.html).\
   \ \n\nHet algoritme is niet het juiste middel om het probleem op te lossen. Het\
   \ risico daarbij bestaat dat het probleem niet wordt opgelost. \n"
 urn: urn:nl:ak:mtr:pba-03
@@ -29,7 +29,7 @@ suggested_roles:
 lifecycle:
 - probleemanalyse
 links:
-- urn:nl:ak:ver:aia-01
+- urn:nl:ak:ver:aia-00
 - urn:nl:ak:ver:awb-01
 template:
   requirement: $REQUIREMENT

measures/2-owp-09-multidisciplinair-inkoopteam.yaml → measures/1-pba-06-multidisciplinair-inkoopteam.yaml

@@ -22,21 +22,21 @@ explanation: '- Bij een project gericht op het ontwikkelen of inkopen van algori
   van de complexiteit van de oplossing zijn meer of minder disciplines en dus te beleggen
   verantwoordelijkheden binnen het team wenselijk.
 
-  - Een multidisciplinair team kan ondersteunen bij het [formuleren van de probleemstelling](1-pba-01-formuleren-probleemdefinitie.md)
-  of [formuleren van de doelstellingen](1-pba-02-formuleren-doelstelling.md) van een
-  project, verkennen van de mogelijke oplossingsrichtingen en het vertalen van de
-  gewenste oplossingsrichting naar de concrete behoefte.
+  - Een multidisciplinair team kan ondersteunen bij het [formuleren van de probleemstelling](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/1-pba-01-formuleren-probleemdefinitie/index.html)
+  of [formuleren van de doelstellingen](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/1-pba-02-formuleren-doelstelling/index.html)
+  van een project, verkennen van de mogelijke oplossingsrichtingen en het vertalen
+  van de gewenste oplossingsrichting naar de concrete behoefte.
 
   '
-urn: urn:nl:ak:mtr:owp-09
+urn: urn:nl:ak:mtr:pba-06
 language: nl
 owners:
 - organization: Algoritmekader
   name: ''
   email: ''
   role: ''
 date: ''
-url: https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/2-owp-09-multidisciplinair-inkoopteam/index.html
+url: https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/1-pba-06-multidisciplinair-inkoopteam/index.html
 subject:
 - publieke-inkoop
 suggested_roles:

measures/2-owp-02-data-beschikbaarheid.yaml

@@ -4,13 +4,13 @@ name: Voer voorafgaand aan een project een data beschikbaarheid, kwaliteit- en t
   uit.
 description: '
 
-  Voer voorafgaand aan een project een data beschikbaarheids- en [datakwaliteitsanalayse](3-dat-01-datakwaliteit.md)
+  Voer voorafgaand aan een project een data beschikbaarheids- en [datakwaliteitsanalayse](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/3-dat-01-datakwaliteit/index.html)
   uit.
 
   '
 explanation: '- Het is van belang om voorafgaand aan een project vast te stellen of
   de data die noodzakelijk is om een algoritme te ontwikkelen of te kunnen gebruiken
-  beschikbaar is, gaat worden en of de data van voldoende [kwaliteit](3-dat-01-datakwaliteit.md)
+  beschikbaar is, gaat worden en of de data van voldoende [kwaliteit](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/3-dat-01-datakwaliteit/index.html)
   is.
 
   - Er moet worden onderzocht of en hoe data vanuit de eigen organisatie, die van

measures/2-owp-03-doel-verwerken-persoonsgegevens.yaml

@@ -21,7 +21,7 @@ explanation: "Persoonsgegevens mogen alleen worden verwerkt voor een ‘welbepaa
   \ het ontwikkelen en gebruiken van het algoritme.\nHet principe van dataminimalisatie\
   \ is toegepast, wat betekent dat een keuze is gemaakt of een persoonsgegevens al\
   \ dan niet strikt noodzakelijk is om het doel te bereiken of dat verwerking ervan\
-  \ achterwege kan blijven.\n\nVoor [het beschermen van deze persoonsgegevens](3-dat-05-pseudonimiseren-anonimiseren.md)\
+  \ achterwege kan blijven.\n\nVoor [het beschermen van deze persoonsgegevens](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/3-dat-04-pseudonimiseren-anonimiseren/index.html)\
   \ wordt per kenmerk aangegeven op welke manier deze kan worden beschermd. Denk hierbij\
   \ aan het anonimiseren, pseudonomiseren, aggregeren van de persoonsgegevens. \n\n\
   Gebruik een [DPIA](../hulpmiddelen/DPIA.md) om bovenstaande zaken te beschrijven.\n\

measures/2-owp-04-gebruikte-techniek.yaml

@@ -9,15 +9,15 @@ explanation: "- Beschrijf wat voor soort algoritme er gebruikt gaat worden voor
   \    - niet-zelflerend algoritme zoals een algoritme gebaseerd op [rekenregels](../../overhetalgoritmekader/soorten-algoritmes.md#rekenregels)\n\
   \n- Beschrijf vervolgens ook:\n    \n    - waarom er voor dit type algoritme wordt\
   \ gekozen\n    - wat de alternatieven zijn en waarom die minder passend zijn?\n\
-  \    - waarom dit algoritme het meest geschikt is om het [beoogde doel](1-pba-02-formuleren-doelstelling.md)\
+  \    - waarom dit algoritme het meest geschikt is om het [beoogde doel](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/1-pba-02-formuleren-doelstelling/index.html)\
   \ van het algoritme te bereiken. \n\n- De precieze details kunnen in dit stadium\
   \ van de levenscyclus waarschijnlijk nog niet ingevuld worden. Maak een goede eerste\
   \ inschatting van de gebruikte techniek. Eventueel kan je er ook voor kiezen om\
   \ verschillende technieken verder te onderzoeken. Dat betekent dat er meerdere algoritmes\
   \ ontwikkeld worden (op basis van verschillende technieken), en je later een definitieve\
   \ keuze maakt. \n\n- Het is belangrijk om uiteindelijk een passend uitlegbaar algoritme\
   \ te selecteren voor de context waarin het wordt toegepast. Daarin moet de afweging\
-  \ gemaakt worden of de technische [uitlegbaarheid](2-owp-30-toepassen_uitlegbaarheidstechnieken.md)\
+  \ gemaakt worden of de technische [uitlegbaarheid](https://minbzk.github.io/Algoritmekader/voldoen-aan-wetten-en-regels/maatregelen/2-owp-33-toepassen-uitlegbaarheidstechnieken/index.html)\
   \ voldoende is in de context die de inzet van het algoritme vereist. Hierbij kan\
   \ ook de conclusie worden getrokken dat een simpeler, inzichtelijker algoritme de\
   \ voorkeur krijgt. \n\n"

measures/2-owp-05-soort-algoritme.yaml

@@ -8,12 +8,16 @@ description: '
 
   '
 explanation: "Het verschilt per type algoritme welke vereisten hierop van toepassing\
-  \ is en waar een aanbieder of gebruiksverantwoordelijke aan moet voldoen. \nDit\
-  \ is mede afhankelijk van de bijbehorende risicoclassificatie. \nHiervoor kan in\
-  \ de nabije toekomst de 'beslisboom' in het Algoritmekader voor worden gebruikt'.\
-  \ \nDeze stap is van groot belang, omdat dit ook bepalend is welke contractuele\
-  \ verplichtingen moeten worden gecreëerd tussen opdrachtgever en opdrachtnemer/aanbieder.\
-  \ \n"
+  \ is en waar een aanbieder of gebruiksverantwoordelijke aan moet voldoen. \n\nDit\
+  \ is mede afhankelijk van de bijbehorende risicoclassificatie. \n\nHiervoor kan\
+  \ de [beslishulp](https://ai-verordening-beslishulp.apps.digilab.network/) in het\
+  \ Algoritmekader voor worden gebruikt'. \n\nLet op dat niet enkel naar de AI-verordening\
+  \ wordt gekeken. Ook op impactvolle algoritmes die niet vallen onder het bereik\
+  \ van de AI-Verordening zijn vereisten van toepassing. Zie hiervoor de Handreiking\
+  \ Algoritmeregister. \n\nDeze stap is van groot belang, omdat dit bijvoorbeeld voor\
+  \ ontwikkelteams mede bepalend is waar het te ontwikkelen systeem aan moet voldoen\
+  \ of welke contractuele verplichtingen moeten worden gecreëerd tussen opdrachtgever\
+  \ en aanbieder van algoritmes.\n"
 urn: urn:nl:ak:mtr:owp-05
 language: nl
 owners: