diff --git a/nl/criteria/bundle-policy-and-source-code.md b/nl/criteria/bundle-policy-and-source-code.md index db96eb1..93333b1 100644 --- a/nl/criteria/bundle-policy-and-source-code.md +++ b/nl/criteria/bundle-policy-and-source-code.md @@ -6,7 +6,7 @@ order: 2 # Bundel beleid en broncode -Toegang tot zowel de [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}) als de [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) biedt bouwstenen voor iedereen om de codebase te implementeren in hun lokale context of om bij te dragen aan de verdere ontwikkeling van de [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}). +Toegang tot zowel de [broncode](../glossary.html#broncode) als de [beleid](../glossary.html#beleid) biedt bouwstenen voor iedereen om de codebase te implementeren in hun lokale context of om bij te dragen aan de verdere ontwikkeling van de [codebase](../glossary.html#codebase). Inzicht in het domein en het beleid binnen dat domein is fundamenteel om te begrijpen welke problemen een codebase probeert op te lossen en hoe de codebase die probeert op te lossen. @@ -20,7 +20,7 @@ Om te kunnen evalueren of een codebase in een nieuwe context kan worden toegepas - Beleid ZOU MOETEN worden aangeleverd in machineleesbare en ondubbelzinnige formaten. -- [Continue integratietests]({{ "/nl/glossary.html#continue-integratie" | relative_url }}) ZOU MOETEN valideren dat de broncode en het beleid coherent worden uitgevoerd. +- [Continue integratietests](../glossary.html#continue-integratie) ZOU MOETEN valideren dat de broncode en het beleid coherent worden uitgevoerd. ## Hoe te testen @@ -36,7 +36,7 @@ Om te kunnen evalueren of een codebase in een nieuwe context kan worden toegepas - Werk samen met ontwikkelaars en ontwerpers om ervoor te zorgen dat er geen discrepantie is tussen de beleidscode en de broncode. -- Geef de relevante beleidsteksten op voor opname in de [repository]({{ "/nl/glossary.html#repository" | relative_url }}). Als de tekst niet in het Engels beschikbaar is, geef dan ook een Engelse samenvatting. Zorg ervoor dat je de standaarden opneemt waaraan je organisatie zich wil houden en alle organisatieprocessen die van invloed zijn op de ontwikkelings- of implementatiecontext van de codebase voor je organisatie. +- Geef de relevante beleidsteksten op voor opname in de [repository](../glossary.html#repository). Als de tekst niet in het Engels beschikbaar is, geef dan ook een Engelse samenvatting. Zorg ervoor dat je de standaarden opneemt waaraan je organisatie zich wil houden en alle organisatieprocessen die van invloed zijn op de ontwikkelings- of implementatiecontext van de codebase voor je organisatie. - Geef referenties en links naar teksten die het beleid ondersteunen. diff --git a/nl/criteria/code-in-the-open.md b/nl/criteria/code-in-the-open.md index 8706c10..a4112f5 100644 --- a/nl/criteria/code-in-the-open.md +++ b/nl/criteria/code-in-the-open.md @@ -6,9 +6,9 @@ order: 1 # Programmeer in het openbaar -Programmeren in het openbaar verbetert transparantie, verhoogt de kwaliteit van de [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}), maakt de broncode makkelijker te controleren en maakt samenwerking mogelijk. +Programmeren in het openbaar verbetert transparantie, verhoogt de kwaliteit van de [broncode](../glossary.html#broncode), maakt de broncode makkelijker te controleren en maakt samenwerking mogelijk. -Samen creëert dit meer mogelijkheden voor burgers om te begrijpen hoe software en [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) hun interacties met een publieke organisatie beïnvloeden. +Samen creëert dit meer mogelijkheden voor burgers om te begrijpen hoe software en [beleid](../glossary.html#beleid) hun interacties met een publieke organisatie beïnvloeden. ## Vereisten @@ -20,13 +20,13 @@ Samen creëert dit meer mogelijkheden voor burgers om te begrijpen hoe software - Alle broncode die momenteel niet in gebruik is (zoals nieuwe versies, voorstellen of oudere versies) ZOU MOETEN worden gepubliceerd. -- Het documenteren van welke broncode of welk beleid ten grondslag ligt aan een specifieke interactie die het [algemeen publiek]({{ "/nl/glossary.html#algemeen-publiek" | relative_url }}) met een organisatie kan hebben, is OPTIONEEL. +- Het documenteren van welke broncode of welk beleid ten grondslag ligt aan een specifieke interactie die het [algemeen publiek](../glossary.html#algemeen-publiek) met een organisatie kan hebben, is OPTIONEEL. ## Hoe te testen - Controleer of de broncode van elke versie die momenteel in gebruik is, op internet is gepubliceerd, waar deze van buiten de oorspronkelijke bijdragende organisatie kan worden bekeken en zonder dat er enige vorm van authenticatie of autorisatie nodig is. -- Controleer of de [codebase]({{ "/nl/glossary.html#codebase" | relative_url }})-bestanden en commit-geschiedenis geen gevoelige informatie bevatten. +- Controleer of de [codebase](../glossary.html#codebase)-bestanden en commit-geschiedenis geen gevoelige informatie bevatten. - Controleer op de publicatie van broncode die momenteel niet in gebruik is. diff --git a/nl/criteria/document-codebase-maturity.md b/nl/criteria/document-codebase-maturity.md index 71f205e..9b4cde0 100644 --- a/nl/criteria/document-codebase-maturity.md +++ b/nl/criteria/document-codebase-maturity.md @@ -6,7 +6,7 @@ order: 16 # Documenteer de volwassenheid van de codebase -Het duidelijk aangeven van de volwassenheid van een [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) helpt anderen om te beslissen of ze de codebase willen gebruiken en eraan willen bijdragen. De volwassenheid van een codebase-versie omvat de volwassenheid van zijn afhankelijkheden. Begrijpen hoe een codebase geëvolueerd is, is de sleutel tot het begrijpen van de codebase en hoe eraan bij te dragen. +Het duidelijk aangeven van de volwassenheid van een [codebase](../glossary.html#codebase) helpt anderen om te beslissen of ze de codebase willen gebruiken en eraan willen bijdragen. De volwassenheid van een codebase-versie omvat de volwassenheid van zijn afhankelijkheden. Begrijpen hoe een codebase geëvolueerd is, is de sleutel tot het begrijpen van de codebase en hoe eraan bij te dragen. ## Vereisten @@ -36,7 +36,7 @@ Het duidelijk aangeven van de volwassenheid van een [codebase]({{ "/nl/glossary. ## Beleidsmakers in de publieke sector: wat je moet doen -- Houd er bij het ontwikkelen van [beleid]({{ "/nl/glossary.html#beleid) rekening mee dat elke ontwikkelde [broncode](/nl/glossary.html#broncode" | relative_url }}) moet worden getest en verbeterd voordat deze in gebruik kan worden genomen. +- Houd er bij het ontwikkelen van [beleid](../glossary.html#beleid) rekening mee dat elke ontwikkelde [broncode](/nl/glossary.html#broncode) moet worden getest en verbeterd voordat deze in gebruik kan worden genomen. - Overweeg versionering van beleidswijzigingen, vooral als de wijzigingen nieuwe versies van de broncode veroorzaken. diff --git a/nl/criteria/document-codebase-objectives.md b/nl/criteria/document-codebase-objectives.md index 86dbd74..54b9298 100644 --- a/nl/criteria/document-codebase-objectives.md +++ b/nl/criteria/document-codebase-objectives.md @@ -6,15 +6,15 @@ order: 8 # Documenteer de doelstellingen van codebase -Het duidelijk documenteren van de doelstellingen van de [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) communiceert de bedoeling van de codebase. Het helpt belanghebbenden en bijdragers de ontwikkeling van de codebase af te kaderen. De doelstellingen bieden ook een gemakkelijke manier voor mensen om te beslissen of deze codebase, of een van modules ervan, nu of in de toekomst interessant voor hen is. +Het duidelijk documenteren van de doelstellingen van de [codebase](../glossary.html#codebase) communiceert de bedoeling van de codebase. Het helpt belanghebbenden en bijdragers de ontwikkeling van de codebase af te kaderen. De doelstellingen bieden ook een gemakkelijke manier voor mensen om te beslissen of deze codebase, of een van modules ervan, nu of in de toekomst interessant voor hen is. ## Vereisten - De codebase MOET documentatie bevatten over haar doelstellingen, zoals een missie- en doelstatement, die begrijpelijk is voor ontwikkelaars en ontwerpers zodat zij de codebase kunnen gebruiken of eraan kunnen bijdragen. -- De documentatie van de codebase ZOU duidelijk de verbanden tussen de [beleidsdoelstellingen]({{ "/nl/glossary.html#beleid" | relative_url }}) en de doelstellingen van de codebase MOETEN beschrijven. +- De documentatie van de codebase ZOU duidelijk de verbanden tussen de [beleidsdoelstellingen](../glossary.html#beleid) en de doelstellingen van de codebase MOETEN beschrijven. -- Het documenteren van de doelstellingen van de codebase voor het [algemeen publiek]({{ "/nl/glossary.html#algemeen-publiek" | relative_url }}) is OPTIONEEL. +- Het documenteren van de doelstellingen van de codebase voor het [algemeen publiek](../glossary.html#algemeen-publiek) is OPTIONEEL. ## Hoe te testen diff --git a/nl/criteria/document-the-code.md b/nl/criteria/document-the-code.md index 3437e77..2c0eabb 100644 --- a/nl/criteria/document-the-code.md +++ b/nl/criteria/document-the-code.md @@ -6,17 +6,17 @@ order: 9 # Documenteer de code -Goed gedocumenteerde [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}) helpt mensen te begrijpen wat de broncode doet en hoe de broncode moet worden gebruikt. Documentatie is onmisbaar voor mensen om de [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) te gaan gebruiken en eraan bij te dragen. +Goed gedocumenteerde [broncode](../glossary.html#broncode) helpt mensen te begrijpen wat de broncode doet en hoe de broncode moet worden gebruikt. Documentatie is onmisbaar voor mensen om de [codebase](../glossary.html#codebase) te gaan gebruiken en eraan bij te dragen. ## Vereisten -- Alle functionaliteit van de codebase, zowel het [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) als de broncode, MOET worden beschreven in een taal die duidelijk te begrijpen is voor degenen die het doel van de codebase begrijpen. +- Alle functionaliteit van de codebase, zowel het [beleid](../glossary.html#beleid) als de broncode, MOET worden beschreven in een taal die duidelijk te begrijpen is voor degenen die het doel van de codebase begrijpen. - De documentatie van de codebase MOET een beschrijving bevatten van hoe de software moet worden geïnstalleerd en uitgevoerd. - De documentatie van de codebase MOET voorbeelden bevatten die de belangrijkste functionaliteit demonstreren. -- De documentatie van de codebase ZOU een algemene beschrijving MOETEN bevatten die duidelijk te begrijpen is voor een breed publiek van belanghebbenden, zoals het [algemeen publiek]({{ "/nl/glossary.html#algemeen-publiek" | relative_url }}) en journalisten. +- De documentatie van de codebase ZOU een algemene beschrijving MOETEN bevatten die duidelijk te begrijpen is voor een breed publiek van belanghebbenden, zoals het [algemeen publiek](../glossary.html#algemeen-publiek) en journalisten. - De documentatie van de codebase ZOU een paragraaf MOETEN bevatten die beschrijft hoe een zelfstandige versie van de broncode kan worden geïnstalleerd en uitgevoerd, inclusief, indien nodig, een testdataset. @@ -24,7 +24,7 @@ Goed gedocumenteerde [broncode]({{ "/nl/glossary.html#broncode" | relative_url } - De documentatie ZOU de belangrijkste componenten of modules van de codebase en hun relaties MOETEN beschrijven, bijvoorbeeld als een hoog-over architectuurdiagram. -- Er ZOUDEN [continue integratietests]({{ "/nl/glossary.html#continue-integratie" | relative_url }}) MOETEN worden uitgevoerd om de kwaliteit van de documentatie te controleren. +- Er ZOUDEN [continue integratietests](../glossary.html#continue-integratie) MOETEN worden uitgevoerd om de kwaliteit van de documentatie te controleren. ## Hoe te testen diff --git a/nl/criteria/maintain-version-control.md b/nl/criteria/maintain-version-control.md index bf12ba2..f5671de 100644 --- a/nl/criteria/maintain-version-control.md +++ b/nl/criteria/maintain-version-control.md @@ -6,7 +6,7 @@ order: 6 # Versiebeheer bijhouden -[Versiebeheer]({{ "/nl/glossary.html#versiebeheer" | relative_url}}) betekent het in de loop van de tijd bijhouden van wijzigingen in de [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}) en andere bestanden van de [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}). Op deze manier kun je gestructureerde documentatie bijhouden van de geschiedenis van de codebase. Dit is essentieel voor samenwerking op grote schaal, omdat het ontwikkelaars in staat stelt om parallel aan bijdragen te werken en toekomstige ontwikkelaars helpt om de redenen voor wijzigingen te begrijpen. +[Versiebeheer](../glossary.html#versiebeheer") betekent het in de loop van de tijd bijhouden van wijzigingen in de [broncode](../glossary.html#broncode) en andere bestanden van de [codebase](../glossary.html#codebase). Op deze manier kun je gestructureerde documentatie bijhouden van de geschiedenis van de codebase. Dit is essentieel voor samenwerking op grote schaal, omdat het ontwikkelaars in staat stelt om parallel aan bijdragen te werken en toekomstige ontwikkelaars helpt om de redenen voor wijzigingen te begrijpen. ## Vereisten @@ -44,7 +44,7 @@ order: 6 ## Beleidsmakers in de publieke sector: wat je moet doen -- Als er een nieuwe versie van de codebase wordt gemaakt vanwege een [beleidswijziging]({{ "/nl/glossary.html#beleid" | relative_url }}), zorg er dan voor dat het volgende duidelijk is in de documentatie: +- Als er een nieuwe versie van de codebase wordt gemaakt vanwege een [beleidswijziging](../glossary.html#beleid), zorg er dan voor dat het volgende duidelijk is in de documentatie: - wat de beleidswijziging is diff --git a/nl/criteria/make-contributing-easy.md b/nl/criteria/make-contributing-easy.md index 5933467..b6de01c 100644 --- a/nl/criteria/make-contributing-easy.md +++ b/nl/criteria/make-contributing-easy.md @@ -6,7 +6,7 @@ order: 5 # Maak bijdragen gemakkelijk -Om betere, betrouwbaardere en functierijke software te ontwikkelen, moeten gebruikers problemen kunnen oplossen, functies kunnen toevoegen en beveiligingsproblemen van de gedeelde [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) kunnen aanpakken. +Om betere, betrouwbaardere en functierijke software te ontwikkelen, moeten gebruikers problemen kunnen oplossen, functies kunnen toevoegen en beveiligingsproblemen van de gedeelde [codebase](../glossary.html#codebase) kunnen aanpakken. Een gedeelde digitale infrastructuur maakt het makkelijker om samen te werken. Hoe minder moeite het kost om bijdragen te leveren die door de codebase worden geaccepteerd, hoe groter de kans dat gebruikers ook bijdragen gaan leveren. @@ -36,7 +36,7 @@ Een gedeelde digitale infrastructuur maakt het makkelijker om samen te werken. H ## Beleidsmakers in de publieke sector: wat je moet doen -- Houd [beleidsissues]({{ "/nl/glossary.html#beleid" | relative_url }}) in de codebase bij, zodat ook externe beleidsexperts vrijwillige hulp kunnen bieden. +- Houd [beleidsissues](../glossary.html#beleid) in de codebase bij, zodat ook externe beleidsexperts vrijwillige hulp kunnen bieden. ## Managers: wat je moet doen diff --git a/nl/criteria/make-the-codebase-findable.md b/nl/criteria/make-the-codebase-findable.md index 82a52cd..e87be58 100644 --- a/nl/criteria/make-the-codebase-findable.md +++ b/nl/criteria/make-the-codebase-findable.md @@ -6,7 +6,7 @@ order: 14 # Maak de codebase vindbaar -Hoe beter een [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) te vinden is, hoe meer potentiële nieuwe samenwerkers deze zullen vinden. Gewoon een codebase publiceren en hopen dat deze wordt gevonden werkt niet, in plaats daarvan is proactiviteit vereist. +Hoe beter een [codebase](../glossary.html#codebase) te vinden is, hoe meer potentiële nieuwe samenwerkers deze zullen vinden. Gewoon een codebase publiceren en hopen dat deze wordt gevonden werkt niet, in plaats daarvan is proactiviteit vereist. Een bestand met metadata-beschrijvingen verhoogt de vindbaarheid. Goed geschreven metadata met een unieke en blijvende identificatie, zoals een Wikidata-item of een vermelding in de FSF-software directory (en op die manier dus onderdeel uitmaken van het semantische web), zorgt ervoor dat mensen gemakkelijker naar de codebase kunnen verwijzen, er uit citeren, codebases van elkaar onderscheiden en ontdekken via overzichtswebsites van derden. @@ -24,7 +24,7 @@ Een bestand met metadata-beschrijvingen verhoogt de vindbaarheid. Goed geschreve - De codebase ZOU vindbaar MOETEN zijn met een zoekmachine door het probleem dat het oplost in natuurlijke taal te beschrijven. -- De codebase ZOU een unieke en persistente identificatie MOETEN hebben waarbij de belangrijkste bijdragers, de locatie van [de repository]({{ "/nl/glossary.html#repository" | relative_url }}) en de website vermeld worden. +- De codebase ZOU een unieke en persistente identificatie MOETEN hebben waarbij de belangrijkste bijdragers, de locatie van [de repository](../glossary.html#repository) en de website vermeld worden. - De codebase ZOU een machineleesbare metadata-beschrijving MOETEN bevatten, bijvoorbeeld in een [publiccode.yml](https://github.com/publiccodeyml/publiccode.yml)-bestand. @@ -64,7 +64,7 @@ Een bestand met metadata-beschrijvingen verhoogt de vindbaarheid. Goed geschreve - Toets je probleemomschrijving bij collega\'s buiten jouw context die niet bekend zijn met de codebase. -- Presenteer op relevante conferenties hoe de codebase het [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) implementeert. +- Presenteer op relevante conferenties hoe de codebase het [beleid](../glossary.html#beleid) implementeert. ## Managers: wat je moet doen diff --git a/nl/criteria/make-the-codebase-reusable-and-portable.md b/nl/criteria/make-the-codebase-reusable-and-portable.md index 36c48ea..8a00633 100644 --- a/nl/criteria/make-the-codebase-reusable-and-portable.md +++ b/nl/criteria/make-the-codebase-reusable-and-portable.md @@ -6,11 +6,11 @@ order: 3 # Maak de codebase herbruikbaar en portabel -Het maken van herbruikbare en portabele [code]({{ "/nl/glossary.html#code" | relative_url }}) stelt beleidsmakers, ontwikkelaars en ontwerpers in staat om wat is ontwikkeld te hergebruiken, te testen, te verbeteren en die verbeteringen weer in te brengen, wat leidt tot betere kwaliteit, goedkoper onderhoud en hogere betrouwbaarheid. +Het maken van herbruikbare en portabele [code](../glossary.html#code) stelt beleidsmakers, ontwikkelaars en ontwerpers in staat om wat is ontwikkeld te hergebruiken, te testen, te verbeteren en die verbeteringen weer in te brengen, wat leidt tot betere kwaliteit, goedkoper onderhoud en hogere betrouwbaarheid. -Het doordacht en doelgericht ontwerpen van een [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) voor herbruikbaarheid zorgt ervoor dat de missie, visie en scope van de codebase door meerdere partijen wordt gedeeld. Codebases die door meerdere partijen worden ontwikkeld en gebruikt, hebben meer kans op een langlevende community. +Het doordacht en doelgericht ontwerpen van een [codebase](../glossary.html#codebase) voor herbruikbaarheid zorgt ervoor dat de missie, visie en scope van de codebase door meerdere partijen wordt gedeeld. Codebases die door meerdere partijen worden ontwikkeld en gebruikt, hebben meer kans op een langlevende community. -Door een codebase zo te organiseren dat deze is samengesteld uit goed gedocumenteerde modules, worden de herbruikbaarheid en het onderhoud ervan verbeterd. Een module is gemakkelijker te hergebruiken in [een andere context]({{ "/nl/glossary.html#verschillende-contexten" | relative_url }}) als het doel ervan duidelijk gedocumenteerd is. +Door een codebase zo te organiseren dat deze is samengesteld uit goed gedocumenteerde modules, worden de herbruikbaarheid en het onderhoud ervan verbeterd. Een module is gemakkelijker te hergebruiken in [een andere context](../glossary.html#verschillende-contexten) als het doel ervan duidelijk gedocumenteerd is. Broncode die niet afhankelijk is van de situatiespecifieke infrastructuur van een bijdrager, leverancier of implementatie kan door elke andere bijdrager worden getest. @@ -26,7 +26,7 @@ Broncode die niet afhankelijk is van de situatiespecifieke infrastructuur van ee - De ontwikkeling van de codebase ZOU een samenwerking MOETEN zijn tussen meerdere partijen. -- Om [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}) aan te passen aan contextspecifieke behoeften ZOU gebruik MOETEN worden gemaakt van configuratie. +- Om [broncode](../glossary.html#broncode) aan te passen aan contextspecifieke behoeften ZOU gebruik MOETEN worden gemaakt van configuratie. - De codebase ZOU *localizable* MOETEN zijn, dat wil zeggen aanpasbaar aan locatiespecifieke omstandigheden zoals taal, karakterset en symbolen. @@ -62,7 +62,7 @@ Broncode die niet afhankelijk is van de situatiespecifieke infrastructuur van ee ## Beleidsmakers in de publieke sector: wat je moet doen -- Documenteer je [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) zo duidelijk en gedetailleerd dat het ook buiten de oorspronkelijke context kan worden begrepen. +- Documenteer je [beleid](../glossary.html#beleid) zo duidelijk en gedetailleerd dat het ook buiten de oorspronkelijke context kan worden begrepen. - Zorg ervoor dat je organisatie als een bekende gebruiker in de codebase wordt vermeld. diff --git a/nl/criteria/publish-with-an-open-license.md b/nl/criteria/publish-with-an-open-license.md index 8bb5d71..53396f4 100644 --- a/nl/criteria/publish-with-an-open-license.md +++ b/nl/criteria/publish-with-an-open-license.md @@ -6,7 +6,7 @@ order: 13 # Publiceer met een open licentie -Een open en gangbare licentie maakt het voor iedereen mogelijk om de [broncode]({{ "/nl/glossary.html#broncode) te bekijken om te begrijpen hoe de broncode werkt, om het vrijelijk te gebruiken en om bij te dragen aan de [codebase](/nl/glossary.html#codebase" | relative_url }}). Hierdoor kan er een ecosysteem van leveranciers ontstaan rond de codebase. +Een open en gangbare licentie maakt het voor iedereen mogelijk om de [broncode](../glossary.html#broncode) te bekijken om te begrijpen hoe de broncode werkt, om het vrijelijk te gebruiken en om bij te dragen aan de [codebase](/nl/glossary.html#codebase). Hierdoor kan er een ecosysteem van leveranciers ontstaan rond de codebase. Door voor elk bestand in een codebase duidelijk de licentie aan te geven, worden hergebruik van delen van de codebase en naamsvermelding daarbij eenvoudiger. @@ -32,13 +32,13 @@ Door voor elk bestand in een codebase duidelijk de licentie aan te geven, worden - Controleer of de licenties die in de codebase worden gebruikt, als bestanden zijn opgenomen. -- Controleer of de bijdragerichtlijnen en de configuratie van de [repository]({{ "/nl/glossary.html#repository" | relative_url }}) geen overdracht van auteursrechten vereisen. +- Controleer of de bijdragerichtlijnen en de configuratie van de [repository](../glossary.html#repository) geen overdracht van auteursrechten vereisen. -- Controleer op machineleesbare licentiecontrole in de [continue integratietests]({{ "/nl/glossary.html#continue-integratie" | relative_url }}) van de codebase. +- Controleer op machineleesbare licentiecontrole in de [continue integratietests](../glossary.html#continue-integratie) van de codebase. ## Beleidsmakers in de publieke sector: wat je moet doen -- Ontwikkel [beleid]({{ "/nl/glossary.html#beleid) dat vereist dat broncode [open source](/nl/glossary.html#open-source" | relative_url }}) is. +- Ontwikkel [beleid](../glossary.html#beleid) dat vereist dat broncode [open source](/nl/glossary.html#open-source) is. - Ontwikkel beleid dat het gebruik van niet-open broncode en technologie bij aanbestedingen ontmoedigt. diff --git a/nl/criteria/require-review-of-contributions.md b/nl/criteria/require-review-of-contributions.md index 6f21059..ac88bb6 100644 --- a/nl/criteria/require-review-of-contributions.md +++ b/nl/criteria/require-review-of-contributions.md @@ -6,11 +6,11 @@ order: 7 # Vereis inspectie van bijdragen -Inspectie van bijdragen door collega\'s is essentieel voor de kwaliteit van de [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}) en het verminderen van beveiligingsrisico\'s en operationele risico\'s. +Inspectie van bijdragen door collega\'s is essentieel voor de kwaliteit van de [broncode](../glossary.html#broncode) en het verminderen van beveiligingsrisico\'s en operationele risico\'s. -Door te eisen dat bijdragen grondig worden nagekeken, wordt een cultuur gestimuleerd waarin ervoor wordt gezorgd dat elke bijdrage van hoge kwaliteit, volledig en van waarde is. Door de broncode te inspecteren, vergroot je de kans dat mogelijke bugs of fouten worden ontdekt en opgelost voordat ze aan de [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) worden toegevoegd. Als je weet dat alle broncode is gecontroleerd, voorkom je dat er een cultuur ontstaat waarin de schuld bij individuen wordt gelegd en stimuleer je een cultuur waarin de focus ligt op oplossingen. +Door te eisen dat bijdragen grondig worden nagekeken, wordt een cultuur gestimuleerd waarin ervoor wordt gezorgd dat elke bijdrage van hoge kwaliteit, volledig en van waarde is. Door de broncode te inspecteren, vergroot je de kans dat mogelijke bugs of fouten worden ontdekt en opgelost voordat ze aan de [codebase](../glossary.html#codebase) worden toegevoegd. Als je weet dat alle broncode is gecontroleerd, voorkom je dat er een cultuur ontstaat waarin de schuld bij individuen wordt gelegd en stimuleer je een cultuur waarin de focus ligt op oplossingen. -Een [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) van snelle beoordelingen garandeert bijdragers een gegarandeerde snelheid van feedback of gezamenlijke verbetering, wat zowel de leveringssnelheid als de betrokkenheid van de bijdragers vergroot. +Een [beleid](../glossary.html#beleid) van snelle beoordelingen garandeert bijdragers een gegarandeerde snelheid van feedback of gezamenlijke verbetering, wat zowel de leveringssnelheid als de betrokkenheid van de bijdragers vergroot. ## Vereisten @@ -24,7 +24,7 @@ Een [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) van snelle beoorde - Bij beoordeling ZOU zowel de software als de tests van de codebase MOETEN worden uitgevoerd. -- Bijdragen ZOUDEN MOETEN worden beoordeeld door iemand in een [andere context]({{ "/nl/glossary.html#verschillende-contexten" | relative_url }}) dan de bijdrager. +- Bijdragen ZOUDEN MOETEN worden beoordeeld door iemand in een [andere context](../glossary.html#verschillende-contexten) dan de bijdrager. - Versiebeheersystemen MOGEN GEEN niet-beoordeelde bijdragen accepteren in releaseversies. @@ -46,7 +46,7 @@ Een [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) van snelle beoorde - Controleer bij de beoordelaars of commits door iemand anders dan de bijdrager, in een andere context zijn beoordeeld. -- Controleer het gebruik van *branch protection* in het [versiebeheersysteem]({{ "/nl/glossary.html#versiebeheer" | relative_url }}). +- Controleer het gebruik van *branch protection* in het [versiebeheersysteem](../glossary.html#versiebeheer). - Controleer of er geen patroon is van tussenpozen tussen het indienen van een bijdrage en de beoordeling ervan, waarbij de bijdrager langer dan twee werkdagen moet wachten op zinvolle reacties. diff --git a/nl/criteria/use-a-coherent-style.md b/nl/criteria/use-a-coherent-style.md index 0689e9a..4d34003 100644 --- a/nl/criteria/use-a-coherent-style.md +++ b/nl/criteria/use-a-coherent-style.md @@ -10,7 +10,7 @@ Door een consistente en coherente stijl te volgen, kunnen bijdragers in verschil ## Vereisten -- De [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) MOET een programmeer- of schrijfstijlgids gebruiken, ofwel die van de codebase-community zelf of een bestaande waarnaar in de codebase wordt verwezen. +- De [codebase](../glossary.html#codebase) MOET een programmeer- of schrijfstijlgids gebruiken, ofwel die van de codebase-community zelf of een bestaande waarnaar in de codebase wordt verwezen. - Bijdragen ZOUDEN aan geautomatiseerde stijltests MOETEN voldoen. @@ -26,7 +26,7 @@ Door een consistente en coherente stijl te volgen, kunnen bijdragers in verschil ## Beleidsmakers in de publieke sector: wat je moet doen -- Maak, volg en verbeter voortdurend een stijlgids voor [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) en documentatie, en documenteer dit in de codebase, bijvoorbeeld in de `CONTRIBUTING` of `README`. +- Maak, volg en verbeter voortdurend een stijlgids voor [beleid](../glossary.html#beleid) en documentatie, en documenteer dit in de codebase, bijvoorbeeld in de `CONTRIBUTING` of `README`. ## Managers: wat je moet doen @@ -34,7 +34,7 @@ Door een consistente en coherente stijl te volgen, kunnen bijdragers in verschil ## Ontwikkelaars en ontwerpers: wat je moet doen -Als de codebase nog geen technische richtlijnen of andere richtlijnen voor bijdragers heeft, begin dan met het toevoegen van documentatie aan de [repository]({{ "/nl/glossary.html#repository) die beschrijft wat er nu wordt gedaan, bijvoorbeeld in de `CONTRIBUTING` of `README`. Een belangrijk doel van het bestand is het communiceren van ontwerpvoorkeuren, naamgevingsconventies en andere aspecten die machines niet eenvoudig kunnen controleren. Richtlijnen moeten bevatten wat er verwacht wordt van [broncodebijdragen](/nl/glossary.html#broncode" | relative_url }}) zodat ze samengevoegd kunnen worden door de beheerders, inclusief broncode, tests en documentatie. Deze documentatie voortdurend verbeteren en uitbreiden met als doel deze documentatie te ontwikkelen tot technische richtlijnen. +Als de codebase nog geen technische richtlijnen of andere richtlijnen voor bijdragers heeft, begin dan met het toevoegen van documentatie aan de [repository](../glossary.html#repository) die beschrijft wat er nu wordt gedaan, bijvoorbeeld in de `CONTRIBUTING` of `README`. Een belangrijk doel van het bestand is het communiceren van ontwerpvoorkeuren, naamgevingsconventies en andere aspecten die machines niet eenvoudig kunnen controleren. Richtlijnen moeten bevatten wat er verwacht wordt van [broncodebijdragen](/nl/glossary.html#broncode) zodat ze samengevoegd kunnen worden door de beheerders, inclusief broncode, tests en documentatie. Deze documentatie voortdurend verbeteren en uitbreiden met als doel deze documentatie te ontwikkelen tot technische richtlijnen. Bovendien: diff --git a/nl/criteria/use-continuous-integration.md b/nl/criteria/use-continuous-integration.md index 9231cc3..bd0c772 100644 --- a/nl/criteria/use-continuous-integration.md +++ b/nl/criteria/use-continuous-integration.md @@ -10,11 +10,11 @@ Asynchrone samenwerking wordt mogelijk gemaakt doordat ontwikkelaars hun werk re Door alle functionaliteit automatisch te testen, weet je zeker dat bijdragen werken zoals bedoeld en geen fouten bevatten. Bovendien kunnen beoordelaars zich richten op de structuur en aanpak van de bijdrage. Hoe gerichter de test, hoe makkelijker het is om fouten duidelijk te identificeren en te begrijpen wanneer ze zich voordoen. -Het documenteren van de [continue integratieworkflow]({{ "/nl/glossary.html#continue-integratie) van een codebase helpt bijdragers om de verwachtingen van bijdragen te begrijpen. Continue integratie maakt het gemakkelijker om de status van de [codebase](/nl/glossary.html#codebase" | relative_url }}) te controleren. +Het documenteren van de [continue integratieworkflow](../glossary.html#continue-integratie) van een codebase helpt bijdragers om de verwachtingen van bijdragen te begrijpen. Continue integratie maakt het gemakkelijker om de status van de [codebase](/nl/glossary.html#codebase) te controleren. ## Vereisten -- Alle functionaliteit in de [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}) MOET geautomatiseerd worden getest. +- Alle functionaliteit in de [broncode](../glossary.html#broncode) MOET geautomatiseerd worden getest. - Bijdragen MOETEN alle geautomatiseerde tests doorstaan voordat ze in de codebase worden opgenomen. @@ -28,7 +28,7 @@ Het documenteren van de [continue integratieworkflow]({{ "/nl/glossary.html#cont - De test- en documentatiedekking van broncode ZOU MOETEN worden gecontroleerd. -- Het testen van [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) en documentatie op consistentie met de broncode en vice versa is OPTIONEEL. +- Het testen van [beleid](../glossary.html#beleid) en documentatie op consistentie met de broncode en vice versa is OPTIONEEL. - Het testen van beleid en documentatie op stijl en gebroken links is OPTIONEEL. diff --git a/nl/criteria/use-open-standards.md b/nl/criteria/use-open-standards.md index 677cb2e..0bc97ac 100644 --- a/nl/criteria/use-open-standards.md +++ b/nl/criteria/use-open-standards.md @@ -6,7 +6,7 @@ order: 11 # Gebruik open standaarden -[Open standaarden]({{ "/nl/glossary.html#open-standaard) garanderen toegang tot de kennis die nodig is om de [codebase](/nl/glossary.html#codebase" | relative_url }}) te gebruiken en eraan bij te dragen. Ze maken interoperabiliteit tussen systemen mogelijk en verminderen het risico op vendor lock-ins. Eenduidige open standaarden maken het mogelijk om beide kanten van een gegevensuitwisseling onafhankelijk van elkaar te ontwikkelen. +[Open standaarden](../glossary.html#open-standaard) garanderen toegang tot de kennis die nodig is om de [codebase](/nl/glossary.html#codebase) te gebruiken en eraan bij te dragen. Ze maken interoperabiliteit tussen systemen mogelijk en verminderen het risico op vendor lock-ins. Eenduidige open standaarden maken het mogelijk om beide kanten van een gegevensuitwisseling onafhankelijk van elkaar te ontwikkelen. ## Vereisten @@ -40,13 +40,13 @@ order: 11 ## Managers: wat je moet doen -- Overweeg om de beoordeling van de naleving van open standaarden op te nemen in [broncodebeoordelingen]({{ "/nl/glossary.html#broncode" | relative_url }}). +- Overweeg om de beoordeling van de naleving van open standaarden op te nemen in [broncodebeoordelingen](../glossary.html#broncode). ## Ontwikkelaars en ontwerpers: wat je moet doen -- Voeg [continue integratietests]({{ "/nl/glossary.html#continue-integratie" | relative_url }}) op naleving van de standaarden toe. +- Voeg [continue integratietests](../glossary.html#continue-integratie) op naleving van de standaarden toe. -- Controleer de commits en andere [repositorybronnen]({{ "/nl/glossary.html#repository" | relative_url }}) op verwijzingen naar standaarden en vergelijk deze met de vermelde standaarden. +- Controleer de commits en andere [repositorybronnen](../glossary.html#repository) op verwijzingen naar standaarden en vergelijk deze met de vermelde standaarden. ## Meer informatie diff --git a/nl/criteria/use-plain-english.md b/nl/criteria/use-plain-english.md index 3a98e2d..41354d8 100644 --- a/nl/criteria/use-plain-english.md +++ b/nl/criteria/use-plain-english.md @@ -8,9 +8,9 @@ order: 10 Engels is de *de facto* taal voor samenwerking bij softwareontwikkeling. Sommige contexten vereisen echter andere talen dan Engels. Daarom kan een codebase een aantal hoofdtalen hebben, waaronder Engels. -Informatie van de overheid moet voor iedereen toegankelijk zijn. Duidelijke en eenvoudige taal zorgt ervoor dat de [code]({{ "/nl/glossary.html#code" | relative_url }}) en wat deze doet, voor een breder publiek begrijpelijk is. +Informatie van de overheid moet voor iedereen toegankelijk zijn. Duidelijke en eenvoudige taal zorgt ervoor dat de [code](../glossary.html#code) en wat deze doet, voor een breder publiek begrijpelijk is. -Vertalingen vergroten verder het mogelijke bereik van een [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}). Een taal die gemakkelijk te begrijpen is, verlaagt de kosten voor het maken en onderhouden van vertalingen. +Vertalingen vergroten verder het mogelijke bereik van een [codebase](../glossary.html#codebase). Een taal die gemakkelijk te begrijpen is, verlaagt de kosten voor het maken en onderhouden van vertalingen. ## Vereisten @@ -20,7 +20,7 @@ Vertalingen vergroten verder het mogelijke bereik van een [codebase]({{ "/nl/glo - Alle documentatie van de codebase MOET up-to-date zijn in alle hoofdtalen. -- Alle [broncode]({{ "/nl/glossary.html#broncode" | relative_url }}) MOET in het Engels zijn opgesteld, behalve wanneer [beleid]({{ "/nl/glossary.html#beleid" | relative_url }}) machine leesbaar als code wordt geïnterpreteerd. +- Alle [broncode](../glossary.html#broncode) MOET in het Engels zijn opgesteld, behalve wanneer [beleid](../glossary.html#beleid) machine leesbaar als code wordt geïnterpreteerd. - Al het gebundelde beleid MOET beschikbaar zijn, of een samenvatting hebben, in alle hoofdtalen. diff --git a/nl/criteria/welcome-contributors.md b/nl/criteria/welcome-contributors.md index b53975b..69c4441 100644 --- a/nl/criteria/welcome-contributors.md +++ b/nl/criteria/welcome-contributors.md @@ -6,7 +6,7 @@ order: 4 # Verwelkom bijdragers -De sfeer in een [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) community zorgt ervoor dat gebruikers de ene codebase wel en de andere niet zullen gebruiken. Door iedereen te verwelkomen als bijdrager kan de community groeien en zichzelf langdurig in stand houden. In een community waarin bijdragers op een duidelijke manier invloed kunnen uitoefenen op de codebase en de doelen en voortgang van de community, is de kans kleiner dat de community zich opsplitst in zich van elkaar af bewegende communities. Nieuwkomers moeten de bestuurs- en besluitvormingsstructuur ("*governance*") van de codebase-community begrijpen en die vertrouwen. +De sfeer in een [codebase](../glossary.html#codebase) community zorgt ervoor dat gebruikers de ene codebase wel en de andere niet zullen gebruiken. Door iedereen te verwelkomen als bijdrager kan de community groeien en zichzelf langdurig in stand houden. In een community waarin bijdragers op een duidelijke manier invloed kunnen uitoefenen op de codebase en de doelen en voortgang van de community, is de kans kleiner dat de community zich opsplitst in zich van elkaar af bewegende communities. Nieuwkomers moeten de bestuurs- en besluitvormingsstructuur ("*governance*") van de codebase-community begrijpen en die vertrouwen. ## Vereisten @@ -46,7 +46,7 @@ De sfeer in een [codebase]({{ "/nl/glossary.html#codebase" | relative_url }}) co ## Beleidsmakers in de publieke sector: wat je moet doen -- Voeg aan de codebase een lijst toe met andere bronnen die voor [beleidsdeskundigen]({{ "/nl/glossary.html#beleid" | relative_url }}), non-gouvernementele organisaties en academici nuttig kunnen zijn om je beleid te begrijpen of te hergebruiken. +- Voeg aan de codebase een lijst toe met andere bronnen die voor [beleidsdeskundigen](../glossary.html#beleid), non-gouvernementele organisaties en academici nuttig kunnen zijn om je beleid te begrijpen of te hergebruiken. - Overweeg om contactgegevens toe te voegen zodat andere beleidsmakers die samenwerking overwegen, je om advies kunnen vragen. diff --git a/nl/standard-print.html b/nl/standard-print.html index 5f20a2d..c180189 100644 --- a/nl/standard-print.html +++ b/nl/standard-print.html @@ -98,7 +98,7 @@

Criteria

{% for page in criteriaPages %}
- {{page.content | markdownify}} + {{page.content | replace: "../glossary.html#", "#" | markdownify}}
{% endfor %}