Programmeringsprojekt utvecklas hela tiden. Nya funktioner tillkommer, saker förbättras och ibland behöver något rättas till. För att göra det lättare att följa utvecklingen använder programmerare versionsnummer och en förändringshistorik.

Formatet jag använder följer löst principerna från Keep a Changelog, men är anpassat efter mina projekt och dess utveckling.

Varför versionsnummer?

Versionsnumret gör det möjligt att se vilken version av en app en använder och vad som har förändrats mellan olika versioner.

En ny version kan till exempel innehålla:

  • Nya funktioner – sådant som inte funnits tidigare.
  • Förändringar – befintliga funktioner som har byggts om eller fungerar på ett annat sätt.
  • Förbättringar – justeringar som gör programmet enklare, tydligare eller trevligare att använda.
  • Buggfixar – fel som har upptäckts och rättats till.
  • Tekniska förändringar – sådant som främst påverkar hur programmet fungerar bakom kulisserna.

Alla förändringar behöver alltså inte vara synliga för användaren. Ibland handlar en version om att göra programmet stabilare, snabbare eller enklare att vidareutveckla.

Vad betyder datumet?

Datumen i versionshistoriken anger när förändringen driftsattes och blev tillgänglig i appen.

Det betyder att datumet inte nödvändigtvis är samma dag som arbetet med förändringen började – eller ens den dag då koden skrevs.

En funktion kan till exempel ha utvecklats under flera veckor, testats och ändrats flera gånger innan den slutligen släpps i en ny version. I versionshistoriken är det då publicerings-/driftsättningsdatumet som anges.

Det gör datumen mer användbara ur användarens perspektiv: de talar om när en viss förändring faktiskt blev en del av den version av appen som du kan använda.

Versionshistoriken

Versionshistoriken är tänkt att ge en överblick över appens utveckling utan att en behöver känna till hur programmet är byggt.


Exempel:

Version 1.2.0 – 2026-08-31

Nytt

  • Möjlighet att söka efter blogginlägg på ett nytt sätt.

Förbättrat

  • Tydligare presentation av relaterade inlägg.
  • Förbättrad hantering av bilder.

Fixat

  • Ett fel som i vissa fall kunde göra att information inte visades korrekt.
  • Version 1.1.1 – 2026-08-12

Fixat

  • Rättat ett mindre fel i bloggformuläret.
  • Förbättrat några texter och meddelanden i programmet.


På det sättet går det att se både vad som har hänt och ungefär när förändringen blev tillgänglig.

Varför inte skriva upp alla små ändringar?

En del appar består av ganska mycket kod och under utvecklingen görs mängder av små förändringar. Alla behöver inte hamna i versionshistoriken.

Versionshistoriken fokuserar därför främst på sådant som är relevant för användaren: nya funktioner, märkbara förbättringar, viktiga förändringar och korrigeringar av fel.

Det betyder att versionshistoriken inte är en fullständig logg över varje kodändring. Den är snarare en sammanfattning av vad som förändrats i den färdiga produkten.

Kort sagt

Versionshistoriken finns för att göra apputvecklingen lite mer transparent.

Versionsnumret talar om vilken version du använder.

Förändringslistan berättar vad som har ändrats.

Datumet visar när förändringen driftsattes och blev tillgänglig.

Och bakom varje versionsnummer finns förstås betydligt fler kodändringar än de som syns i listan – men tanken är att du som användare ska slippa läsa en logg över varje liten programmeringsändring för att förstå vad som faktiskt har hänt.