Skip to content

Commit

Permalink
hack fix breaking relative_url filter
Browse files Browse the repository at this point in the history
  • Loading branch information
jgroenen committed Oct 14, 2024
1 parent a1a6c79 commit fce5474
Show file tree
Hide file tree
Showing 17 changed files with 53 additions and 53 deletions.
6 changes: 3 additions & 3 deletions nl/criteria/bundle-policy-and-source-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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

Expand All @@ -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.

Expand Down
8 changes: 4 additions & 4 deletions nl/criteria/code-in-the-open.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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.

Expand Down
4 changes: 2 additions & 2 deletions nl/criteria/document-codebase-maturity.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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.

Expand Down
6 changes: 3 additions & 3 deletions nl/criteria/document-codebase-objectives.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
8 changes: 4 additions & 4 deletions nl/criteria/document-the-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,25 +6,25 @@ 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.

- De documentatie van de codebase ZOU voorbeelden MOETEN bevatten van alle functionaliteit.

- 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

Expand Down
4 changes: 2 additions & 2 deletions nl/criteria/maintain-version-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down
4 changes: 2 additions & 2 deletions nl/criteria/make-contributing-easy.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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

Expand Down
6 changes: 3 additions & 3 deletions nl/criteria/make-the-codebase-findable.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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.

Expand Down Expand Up @@ -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

Expand Down
10 changes: 5 additions & 5 deletions nl/criteria/make-the-codebase-reusable-and-portable.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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.

Expand Down Expand Up @@ -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.

Expand Down
Loading

0 comments on commit fce5474

Please sign in to comment.