3. Wees transparant en gebruik open source
Open source is de manier van werken waarbij de makers van systemen de broncode openbaar beschikbaar maken met een opensource-licentie. Hierdoor kan iedereen de software bekijken en hergebruiken. De overheid volgt het beleid ‘Open, tenzij’: software van de overheid moet zoveel mogelijk open source zijn, behalve als er goede redenen zijn om de software niet beschikbaar te maken.
Aan de slag met NL Design System
Wil je snel aan de slag met NL Design System? In deze handleiding laten we je zien hoe je het lokaal kunt opzetten en hoe je experimenteert met de beschikbare componenten.
CODE_OF_CONDUCT.md
Voorbeeld van OSPO-NL:
CONTRIBUTING.md
Een goede CONTRIBUTING.md helpt potentiële bijdragers om efficiënt en effectief bij te dragen aan een project.
Een licentie kiezen
De keuze van een licentie voor je project bepaalt wat anderen met jouw code mogen en kunnen doen.
Leidraad verantwoorde softwareontwikkeling
Deze lijst met principes is een eerste aanzet tot overheidsbreed beleid voor softwareontwikkeling. Het idee van deze lijst is afkomstig van de "Technology Code of Practice" van de Britse overheid. In deze initiële versie willen we voornamelijk alle relevante informatie en kennis binnen de overheid bundelen en op een centrale plek en toegankelijk maken, zonder hierover een expliciet oordeel te vellen.
NL Design System
NL Design System is een project dat specialisten van verschillende overheidsorganisaties laat samenwerken aan concrete oplossingen voor websites en applicaties. Denk bijvoorbeeld aan code, ontwerp en richtlijnen.
Open Source werken
Open source werken is de manier van werken waarbij de makers van systemen de broncode openbaar beschikbaar maken met een opensource-licentie. Hierdoor kan iedereen de software bekijken en hergebruiken. De overheid volgt het beleid ‘Open, tenzij’: software van de overheid moet zoveel mogelijk open source zijn, behalve als er goede redenen zijn om de software niet beschikbaar te maken.
Open Source werken met Gitflow
Wat is Git? Git is een versiebeheersysteem (Version Control System). Maar wat is dat precies?
OpenKAT
Dit artikel is geschreven door Jan Klopper, Leader Developer bij OpenKat (VWS)
Project launch checklist
Project Launch Checklist
PROJECT_GOVERNANCE.md
Voorbeeld van OSPO-NL:
Publiccode.yml
Om inzichtelijk te maken wat de code van een open source project precies doet is het nodig dat er ergens metadata over het project beschikbaar is. Hiervoor is de publiccode.yml standaard in het leven geroepen. Deze standaard heeft twee belangrijke doelen:
Publiccode.yml parser
Deze publiccode.yml parser is gebouwd in Go door het team van Developer Italia. Het stelt je in staat om je publiccode.yml file te checken op errors in je pipeline.
Quality Time
Dit artikel is geschreven door Frank Niessink, Quality Manager bij ICTU
README.md
Een README.md bestand dient ervoor om de belangrijkste informatie over een project te verstrekken. Een aantal dingen die in een readme terug zouden moeten komen zijn:
Standaard voor publieke code
De standaard voor publieke code, of in het Engels: Standard for Public Code, is een gids die beoogt handvatten te geven bij het werken aan Open Source Software in de publieke sector.
Voeg een publiccode.yml toe en valideer deze met VSCode
Werk jij liever in een web-editor? Dan kan je gebruik maken van de Publiccode.yml Editor