Skip to content
This repository has been archived by the owner on Feb 25, 2025. It is now read-only.

Files

Latest commit

 

History

History
21 lines (19 loc) · 6.14 KB

codeNL.md

File metadata and controls

21 lines (19 loc) · 6.14 KB

Bron

Thema Beleidsmakers (B) Managers (M) Ontwikkelaars/Ontwerpers (O)
Programmeer in het openbaar Beleid openbaar ontwikkelen en transparantie centraal stellen Cultuur bevorderen waarin openheid, leren en feedback centraal staan Bijdragen controleren op gevoelige info, strikte scheiding tussen data en broncode
Bundel beleid en broncode Samen met ontwikkelaars zorgen voor geen discrepantie tussen beleid en code; machineleesbare formaten Houd beleidsmakers en ontwikkelaars betrokken en zorg voor gedeelde doelen Begrijp procesmodelleringsnotatie; geef feedback over beleidscodering en documentatie
Maak de codebase herbruikbaar Documenteer beleid helder voor bredere context en identificeer samenwerkingsmogelijkheden Leg uit dat herbruikbaarheid expliciet doel is; stimuleer samenwerking met andere teams Ontwerp code voor hergebruik en aanpasbaarheid; vermijd situatiespecifieke data; documenteer afhankelijkheden
Verwelkom bijdragers Voeg bronnen toe voor beleidsinzicht voor externen Documenteer wijzigingsprocedures, reserveer budget voor bijdragenbeoordeling Reageer snel op verzoeken, communiceer helder integratienormen
Maak bijdragen gemakkelijk Houd lijst met openstaande beleidsvragen bij Houd lijst met managementvragen bij; moedig ervaren teamleden aan om bij te dragen Reageer vlot op verzoeken, vermeld contactgegevens duidelijk (README, publiccode.yml)
Houd versiebeheer bij Leg bij beleidswijziging vast wat en waarom code wijzigt Stimuleer duidelijkheid over verbeteringen; geen imago-schade angst voor wijzigingen Alle bestanden in versiebeheer; duidelijke bijdrageberichten met verwijzingen naar discussies
Vereis inspectie van bijdragen Hanteer vierogenprincipe op alles, niet alleen code Maak geweldig software maken tot gezamenlijk doel; waardeer code reviews Vraag review, reageer snel op reviewverzoeken, focus eerst op conceptfeedback
Documenteer de doelstellingen Voeg beleidsdoelen toe aan documentatie (README) Voeg organisatie- en bedrijfsdoelen toe aan README Voeg technologie- en ontwerpdoelen toe aan README
Documenteer de code Begrijp en toets leesbaarheid documentatie niet-beleidscode Test codebase zelf en geef feedback op documentatiehelderheid Controleer wijzigingen in niet-broncode, geef feedback op documentatie
Gebruik eenvoudig Engels Check of anderen begrijpen wat je oplevert, eenvoudige taal Bepaal hoofdtalen, zorg voor vertalingen, beperk jargon en onduidelijke termen Check bij anderen of documentatie begrijpelijk is, onderscheid hoofd- en best effort-vertalingen
Gebruik open standaarden Verplicht gebruik van open standaarden, ontmoedig niet-open technologie Overweeg naleving open standaarden in code reviews Voeg CI-tests toe voor naleving standaarden, controleer bijdragen op standaarden
Test regelmatig op conflicten Zorg voor geautomatiseerde tests beleid, herstel snel bij falen Test vaak met eindgebruikers, incremental delivery, leer van incidenten Deel werk in kleine stappen, structureer code voor testbare scenario’s, optimaliseer test-dekking
Publiceer met een open licentie Ontwikkel beleid voor open source verplicht stellen Werk samen met open source leveranciers, let op licentievereisten Voeg licentiebestand toe, check licentiecompatibiliteit bij hergebruik
Maak de codebase vindbaar Beschrijf beleidsdomein duidelijk, presenteer op conferenties Controleer merknaam, gebruik korte beschrijving consistent, budget voor SEO en content Optimaliseer voor zoekmachines (bv. sitemap), presenteer op conferenties
Gebruik een coherente stijl Continue verbetering stijlrichtlijnen beleid en documentatie Neem taal- en codeconventies op in kwaliteitsdefinitie Stel technische richtlijnen op, gebruik linters en stijltesten
Beschrijf de volwassenheid Overweeg versiebeheer voor beleidswijzigingen Gebruik geen onrijpe codebases in productie Volg versiebeheerstrategie, onderhoud changelog, maak duidelijk welke versies productierijp zijn