Algoritmekader

Welkom op de Github repo voor het algoritmekader!

Hoe kan je bijdragen aan de ontwikkeling van het algortimekader?

We ontwikkelen het algoritmekader open source via GitHub. Voor de documentatie maken we gebruik van Markdown bestanden. Dit bestandsformaat wordt door veel verschillende tools ondersteund, en maakt het eenvoudig versiebeheer op het algoritmekader toe te passen. Hierdoor hebben we grip op reviews en verschillende versies van het kader.

Vooralsnog maken we tijdens de ontwikkelfase gebruik van mkdocs om de documtentatie inzichtelijk te maken op een website. Hiermee faciliteren we ook al in de ontwikkelfase interactiviteit en flexibiliteit. Uiteindelijk is de bedoeling dat het algoritmekader onderdeel wordt van een bestaande overheidswebsite zoals Digitale Overheid.

Als je wilt bijdragen aan het algoritmekader, is dat voor ons het makkelijkst via GitHub en de markdown bestanden. Hieronder volgen een aantal mogelijkheden hoe je dat kan doen:

Ben je collaborator?

Met fork en een pull request

1. Maak een fork van de repository door rechtsboven op de knop fork te klikken. Je hebt nu een eigen versie (repository) van het algoritmekader op je eigen account.
2. Je kan de bestanden nu bewerken door in de mappenstructuur (de docs map) te navigeren naar het juiste bestand, en rechtsboven op de edit knop te klikken (het potloodje). Mocht je nog geen fork hebben gemaakt, dan kan wordt hier eerst gevraagd een fork te maken. Je kan ook nieuwe bestanden toevoegen door rechtsboven op add file te klikken.
3. Wanneer je je aanpassingen wilt opslaan, klik je rechtsboven op de commit changes knop. Je wordt nu gevraagd om een commit message mee te geven. Geef hier een korte omschrijving van jouw aanpassing, bijvoorbeeld hoofdstuk over normen toegevoegd of typo's verbeterd. Je kan dit direct op de main branch committen.
4. Wanneer je tevreden bent over jouw aanpassingen, en deze wilt samenvoegen met de versie in productie kan je een pull request aanmaken. Bovenaan jouw versie van de repository staat nu een bericht: jouw branche is x commits ahead of ... met vervolgens een knop contribute. Klik op contribute en vervolgens op open pull request. Je komt nu op een pagina waar je de verschillen tussen jouw versie en de andere versie kan zien. Check nogmaals of je tevreden bent en klik nogmaals op open pull request.
5. Het team van algoritmekader bekijkt nu jouw aanpassingen en zal indien akkoord jouw aanpassingen mergen.

Lokaal draaien van de website