Använd kontinuerlig integrering

Asynkront samarbete möjliggörs genom att utvecklare ofta sammanslår sitt arbete till en delad gren, verifierat av automatiserade tester. Ju oftare sammanslagning sker och ju mindre bidraget är, desto enklare är det att lösa sammanslagningskonflikter.

Automatiserad testning av all funktionalitet ger förtroende för att bidrag fungerar som avsett och inte har infört fel, och gör det möjligt för granskare att fokusera på bidragets struktur och tillvägagångssätt. Ju mer fokuserat testet är, desto enklare är det att tydligt identifiera och förstå fel när de uppstår.

Att dokumentera en kodbas’ arbetsflöde för kontinuerlig integrering hjälper bidragsgivare att förstå vad som förväntas av bidrag. Kontinuerlig integrering möjliggör enklare övervakning av kodbasens tillstånd.

Krav

• All funktionalitet i källkoden MÅSTE ha automatiserade tester.
• Bidrag MÅSTE klara alla automatiserade tester innan de tas in i kodbasen.
• Kodbasen MÅSTE ha riktlinjer som förklarar hur bidrag ska struktureras.
• Kodbasen MÅSTE ha aktiva bidragsgivare som kan granska bidrag.
• Automatiserade testresultat för bidrag BÖR vara offentliga.
• Kodbasens riktlinjer BÖR ange att varje bidrag bör fokusera på ett enskilt ärende.
• Källkodens test- och dokumentationstäckning BÖR övervakas.
• Att testa regelverk och dokumentation för överensstämmelse med källkoden och vice versa är VALFRITT.
• Att testa regelverk och dokumentation för stil och trasiga länkar är VALFRITT.
• Att testa programvaran genom att använda exempel i dokumentationen är VALFRITT.

Hur du testar

• Bekräfta att det finns tester.
• Bekräfta att verktyg för källkodstäckning kontrollerar att täckningen är 100 % av källkoden.
• Bekräfta att bidrag bara tas in i kodbasen efter att alla tester godkänts.
• Bekräfta att riktlinjer för bidrag förklarar hur bidrag ska struktureras.
• Bekräfta att det finns bidrag från de senaste tre månaderna.
• Kontrollera att testresultaten kan granskas.
• Kontrollera om data om källkodstäckning publiceras.

Offentliga beslutsfattare: vad ni behöver göra

• Engagera chefer samt utvecklare och formgivare så tidigt i processen som möjligt och håll dem engagerade genom hela utvecklingen av ert regelverk.
• Se till att det också finns automatiserade tester uppsatta för regelverksdokumentation.
• Åtgärda regelverksdokumentation skyndsamt om den underkänns i ett test.
• Se till att källkoden speglar alla ändringar i regelverket (se Upprätthåll versionshantering).

Chefer: vad ni behöver göra

• Se till att testa med verkliga slutanvändare så snabbt och ofta som möjligt.
• Planera arbetet så att små delar integreras mycket ofta i stället för stora delar mer sällan.
• Upphandla konsulttjänster som levererar stegvis i linje med planen.
• Efter ett allvarligt fel, uppmuntra till att publicera incidentrapporter och föra offentlig diskussion om vad som lärdes.

Utvecklare och formgivare: vad ni behöver göra

• Hjälp chefer att strukturera arbetsplanen så att den kan integreras som små steg.
• Hjälp bidragsgivare att begränsa omfattningen av sina bidrag och funktionsönskemål till att vara så små som rimligt.
• Hjälp chefer och beslutsfattare att testa sina bidrag, till exempel genom att testa deras bidrag för trasiga länkar eller stil.
• Om viss källkod hanterar förhållanden som är svåra att skapa i en testmiljö, strukturera den så att förhållandena kan simuleras under testning. Resursutmattning som att lagringsutrymmet tar slut och misslyckad minnesallokering är typiska exempel på svårskapade förhållanden.
• Justera verktyg för testtäckning av kod för att undvika falsklarm till följd av inlining eller andra optimeringar.
• Driftsätt ofta.
• Integrera ert arbete minst en gång om dagen.

Vidare läsning

• What is continuous integration av Martin Fowler.
• Use continuous delivery av UK Government Digital Service.
• Quality assurance: testing your service regularly av UK Government Digital Service.