Algoritmekader

Het Ministerie van Binnenlandse Zaken en Koninkrijksrelaties ontwikkelt het Algoritmekader op een open manier via Github. Het doel van het Algoritmekader is om overheden op een praktische wijze te ondersteunen, zodat zij op een wettige en ethisch verantwoorde wijze algoritmes en AI-systemen gebruiken.

In deze repository ontwikkelen wij het Algoritmekader. De informatie van het Algoritmekader wordt uitgewerkt in verschillende Markdown bestanden (een bestandsformaat voor platte tekstbestanden), welke je terug kan vinden in de map docs. Deze bestanden worden inzichtelijk gemaakt met behulp van MkDocs en Material for MkDocs.

Het Algoritmekader kun je bekijken op https://minbzk.github.io/Algoritmekader.

Hoe kun je bijdragen?

Dat kan op verschillende manieren. Zie onze Contributing Guidelines voor meer uitleg over hoe je kan bijdragen aan het Algoritmekader.

Lokaal ontwikkelen

Het Algoritmekader project kan lokaal met behulp van Python worden gedraaid. Installeer hiervoor de benodigde packages in een virtual environment:

pip install -r requirements.txt

Vervolgens kun je een preview van het Algoritmekader bekijken:

mkdocs serve

Validatie Tools

In de map scripts/validation/ vind je scripts die de consistentie van het Algoritmekader controleren:

• validate_urn_uniqueness.py: Controleert of alle URNs uniek zijn
• validate_lifecycles.py: Controleert of levenscyclus-waarden geldig zijn
• validate_file_prefix_urn.py: Controleert of bestandsnamen overeenkomen met URNs

Gebruik

Bij pull requests worden deze validaties automatisch uitgevoerd via GitHub Actions. Je kunt ze ook lokaal draaien:

# Installeer benodigde dependencies
pip install pyyaml

# Voer alle validaties uit
python .github/scripts/run_all_validations.py

De scripts controleren:

• Dat er geen dubbele URNs zijn (bijvoorbeeld urn:nl:ak:mtr:org-02)
• Dat alle levenscyclus-waarden geldig zijn (zoals organisatieverantwoordelijkheden, ontwikkelen)
• Dat bestandsnamen consistent zijn met hun URNs

Index bestanden (index.md) worden automatisch overgeslagen en bestandsnamen met numerieke voorvoegsels (zoals 0-org-01-...) worden correct herkend.

Voor meer details, zie de README in de .github/scripts map.

Vragen?

Maak een Issue aan op GitHub. Of stuur een e-mail naar [email protected].