Teknik · Årskurs 7 · Algoritmernas logik och struktur · Hösttermin

Testning och dokumentation

Eleverna lär sig vikten av att testa program och dokumentera sin kod för framtida användning.

• Skolverket Kursplaner
• Lgr22: Teknik - Åk 7-9 - Dokumentation av tekniska lösningar
• Lgr22: Teknik - Åk 7-9 - Strategier för att skriva och felsöka kod

Om detta ämne

Testning och dokumentation är grundläggande färdigheter i programmering. Eleverna i årskurs 7 lär sig att systematiskt testa program för att hitta fel och säkerställa funktionalitet, samt dokumentera kod med kommentarer och beskrivningar. Detta kopplar direkt till Lgr22:s krav på strategier för att skriva och felsöka kod, samt dokumentation av tekniska lösningar. Genom att testa egna och andras program upptäcker eleverna hur små förändringar påverkar helheten, och de övar på att förklara sitt tänkande.

Ämnet stärker samarbetsförmåga och långsiktigt tänkande, eftersom god dokumentation underlättar för andra att förstå och vidareutveckla koden. Eleverna designar testplaner för enkla program, som loopar eller villkor, och reflekterar över varför peer testing är viktigt. Det bygger debugging-färdigheter som är essentiella i digitalt skapande och tekniska system.

Aktivt lärande passar utmärkt för detta ämne, eftersom eleverna snabbt ser effekter av sina tester i realtid. När de byter kod med kompisar, utför systematiska kontroller och diskuterar dokumentation i grupp, blir abstrakta begrepp konkreta och minnesvärda. Sammanlagt cirka 170 ord.

Nyckelfrågor

1. Varför är det viktigt att låta andra testa ens programkod?
2. Designa en testplan för ett enkelt program.
3. Förklara hur god dokumentation underlättar samarbete och underhåll av kod.

Lärandemål

• Identifiera och klassificera olika typer av fel i ett givet program.
• Designa en systematisk testplan för att verifiera funktionaliteten i ett enkelt program.
• Förklara hur kommentarer i kod bidrar till förståelse och underhåll.
• Utvärdera effektiviteten av en testplan baserat på dess förmåga att hitta fel.
• Skapa tydlig dokumentation för en enkel algoritm.

Innan du börjar

Grundläggande programmeringskoncept (variabler, loopar, villkor)

Varför: Eleverna behöver en grundläggande förståelse för hur kod fungerar för att kunna testa och dokumentera den.

Algoritmer och problemlösning

Varför: Förståelse för att bryta ner problem i steg är en förutsättning för att kunna designa testfall och förklara kodens logik.

Nyckelbegrepp

Bug	Ett fel i programkoden som gör att programmet inte fungerar som förväntat eller kraschar.
Testfall	En specifik uppsättning instruktioner eller indata som används för att kontrollera om en del av programmet fungerar korrekt.
Dokumentation	Beskrivningar och kommentarer som läggs till i koden för att förklara hur den fungerar, dess syfte och hur den används.
Felsökning (Debugging)	Processen att identifiera, analysera och åtgärda fel (buggar) i programkod.

Se upp för dessa missuppfattningar

Vanlig missuppfattning

Min kod fungerar alltid perfekt för mig, så den behöver inte testas.

Vad man ska lära ut istället

Andra användare kan mata in oväntade värden som avslöjar buggar. Aktiva peer-tester visar eleverna detta direkt, när de ser hur kompisens input orsakar fel. Diskussioner kring resultaten bygger förståelse för robust kod.

Vanlig missuppfattning

Dokumentation är onödigt om koden fungerar.

Vad man ska lära ut istället

Utan dokumentation blir det svårt att komma ihåg eller dela koden senare. Gruppaktiviteter där elever tolkar varandras okommenterade kod understryker värdet, och de lär sig skriva tydliga kommentarer genom praktik.

Vanlig missuppfattning

Testning handlar bara om att köra programmet en gång.

Vad man ska lära ut istället

Systematiska testplaner täcker olika scenarier. Workshops med testplaner hjälper elever att planera flera fall, och de ser hur enstaka tester missar fel som gruppbaserade aktiviteter fångar upp.

Idéer för aktivt lärande

Parvis Peer Testing: Byt och testa kod

Låt elever skriva ett enkelt program i Scratch med loopar och villkor. Byt program med en partner och använd en testplan med tre testfall: normalt fall, gränsfall och felaktig inmatning. Diskutera funna buggar tillsammans.

30 min·Par

Gruppworkshop: Designa testplan

Dela in i små grupper. Ge ett färdigt program med kända fel. Grupperna skapar en testplan med steg-för-steg-tester och förutsägelser om resultat. Presentera planen för klassen.

45 min·Smågrupper

Dokumentationsutmaning: Förbättra andras kod

Elever får en okommenterad kod från en kompis. Lägg till kommentarer, beskriv förändringar i en loggfil och testa koden. Jämför original och förbättrad version i helklassdiskussion.

40 min·Individuellt

Helklass Code Review: Gemensam felsökning

Visa ett program på projektorn med dolda fel. Elever föreslår tester i tur och röstning, dokumenterar resultaten på delade tavlor. Upprepa med elevers egna bidrag.

35 min·Hela klassen

Kopplingar till Verkligheten

• Mjukvaruutvecklare på företag som Spotify använder testning och dokumentation dagligen för att säkerställa att musiktjänsten fungerar felfritt för miljontals användare globalt. De skriver tester för nya funktioner och dokumenterar hur dessa funktioner är byggda.
• Spelutvecklare på Mojang Studios testar noggrant varje ny uppdatering av Minecraft för att hitta och åtgärda buggar innan spelare får tillgång till dem. Tydlig dokumentation av spelmekanik hjälper nya utvecklare att snabbt komma in i projektet.

Bedömningsidéer

Utgångsbiljett

Ge eleverna ett kort kodavsnitt med en avsiktlig bugg. Be dem skriva ner en mening som beskriver buggen och en mening om hur de skulle testa för att hitta den. Samla in svaren för att bedöma förståelsen av felsökning och testning.

Kamratbedömning

Eleverna får i par testa varandras enkla program (t.ex. en miniräknare). De ska skriva ner minst två testfall de använde och en kommentar om koden är lätt att förstå. Ge feedback på hur väl testfallen täcker olika scenarier och hur tydlig dokumentationen är.

Snabbkontroll

Ställ frågor som: 'Varför är det viktigt att testa kod som andra ska använda?' och 'Ge ett exempel på vad som kan dokumenteras i kod.' Använd snabba handuppräckningar eller en digital plattform för att samla in svar och bedöma klassens förståelse.

Vanliga frågor

Varför är peer testing viktigt i programmering?

Peer testing avslöjar buggar som skaparen missar, eftersom andra tänker annorlunda kring input. Det främjar samarbete och kritiskt tänkande, som i Lgr22. Elever lär sig att koden måste fungera för alla, inte bara en själv. Praktiska byten av kod gör lärandet engagerande och effektivt.

Hur designar man en bra testplan för kod?

En testplan inkluderar normala fall, gränsvärden och felinput. Lista förväntade resultat för varje test. Börja med enkla program i Scratch. Låt elever öva i grupper för att jämföra planer och förbättra dem gemensamt, vilket stärker systematiskt tänkande.

Hur kan aktivt lärande hjälpa elever med testning och dokumentation?

Aktivt lärande gör abstrakta begrepp konkreta genom peer testing och gemensamma code reviews. Elever ser buggar i realtid när de testar varandras kod, och diskuterar dokumentation i par. Detta ökar motivationen, minskar rädsla för fel och bygger självständiga debugging-färdigheter, i linje med Lgr22:s fokus på praktiska strategier.

Vad är skillnaden mellan testning och dokumentation?

Testning verifierar att koden fungerar genom systematiska körningar, medan dokumentation förklarar hur och varför koden är skriven med kommentarer och loggar. Båda behövs för underhåll. Kombinera dem i aktiviteter där elever testar och dokumenterar samtidigt för att se helheten.