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 |
This repository has been archived by the owner on Feb 25, 2025. It is now read-only.