Så skriver du effektiva versionsanteckningar för programvara
Om ditt företag är som de flesta andra är versionsanteckningar för programvara något man tänker på i efterhand, eller som verkar vara ett meningslöst besvär. De sätts ihop i sista minuten och innehåller kanske bara en eller två meningar.
Men du kan förvandla det som verkar vara ett tråkigt krav till ett fantastiskt verktyg för att engagera din kundgemenskap, få människor att skratta och le åt ditt varumärke samt bygga förtroende hos dina slutanvändare. Det här är din chans att kommunicera med din kundbas och visa marknaden vilken kvalitetsnivå du har i din programvaruutvecklingsprocess.
Genom att ta dig tid att skriva effektiva versionsanteckningar kan du öka kundnöjdheten och användningen av produkten. Det förbättrar den mer övergripande användarupplevelsen. Dessutom visar du att ditt företag hanterar sin livscykel för programvaruleveranser som en väloljad maskin.
Continue Reading for Free
Create a free account to finish this article, plus get ongoing access to timely insights and practical resources.
Have an account? Log In
När jag var delägare och ansvarade för produktledning & produktmarknadsföring på DigiQuatics använde jag företagets blogg för våra produktuppdateringar. Jag kompletterade detta med små, lättillgängliga inlägg om produktuppdateringar i sociala medier, med länkar tillbaka till bloggen, och använde slutligen bloggens prenumerantlista för att skicka ut en e-postuppdatering.
Att bygga denna maskin kring vår process för versionsanteckningar gjorde det möjligt för våra kunder att veta att deras feedback inte bara lyssnades på, utan också omsattes i praktiken. Det bygger förtroende hos våra slutanvändare och gör att det hårda arbete som produktansvariga och utvecklingsteam lägger ned kan synliggöras för resten av världen.
Du hittar ett exempel på en av våra produktuppdateringar från DigiQuatics här.
- Hur skapar man effektfulla versionsanteckningar för programvara?
- Rekommenderad mall för versionsanteckningar
- Exempel på versionsanteckningar för programvara
- Verktyg för att sprida versionsanteckningar för programvara
Hur skapar man effektfulla versionsanteckningar för programvara?
Versionsanteckningar för programvara är ett tillfälle att hålla dina kunder entusiastiska över din produkt. Lyft fram nya funktioner och buggfixar på ett sätt som är lätt för kunderna att förstå. Se dock till att inkludera nyckelord så att slutanvändarna enkelt kan hitta information om lanseringen på Google eller via bloggens sökfunktion.
Det är viktigt att vara tydlig, koncis och informativ när du skriver versionsanteckningar för programvara. Här är några tips på hur du skriver effektiva versionsanteckningar (kom ihåg att detta är ett utmärkt användningsområde för AI inom lanseringshantering):
- Var tydlig – med vad som är nytt i lanseringen. Vilka funktioner eller vilken funktionalitet lanserar du? Hur kommer det att gynna dina kunder?
- Ha kunden i fokus – versionsanteckningar handlar inte om att utvecklare skriver till utvecklare. Tänk på kunden när du skriver dina anteckningar och spara den tekniska jargongen till de tekniska teammedlemmarna
- Lyft fram buggfixar – Se till att nämna vilka buggar och defekter som har åtgärdats. Kunderna blir glada över att se att du har lyssnat på deras feedback och tagit itu med deras problem
- Var uppmärksam på tonen – i dina versionsanteckningar. Du vill låta entusiastisk över produktförbättringarna utan att låta som om du överdriver deras betydelse. Versionsanteckningar är trots allt ingen säljtext
- Strö in innehåll – Fånga användarnas uppmärksamhet genom att lägga till inbäddade videor och skärmbilder, gif-animeringar, relevanta länkar och till och med visa produktens färdplan när det passar
Rekommenderad mall för versionsanteckningar
Även om det inte finns någon absolut regel kommer du att få en välskriven och komplett versionsanteckning genom att följa denna struktur. Se den som din mall för versionsanteckningar för nya funktioner, förbättringar och buggfixar.
- Rubrik
- Din rubrik eller ditt sidhuvud för varje ny funktion, funktionalitet eller appuppdatering
- Beskrivning
- Ett par meningar om vad som är nytt, vilka förbättringar som har gjorts eller hur en bugg har åtgärdats
- Medieinbäddningar
- Eventuella kompletterande skärmbilder, videor eller annat innehåll som kan ge en tydligare bild av vad den nya funktionen, funktionaliteten eller buggfixen handlar om
- Relevanta länkar
- Alla relevanta länkar till dokumentation eller teknisk information om produkten för de ingenjörer i målgruppen som kan behöva fördjupa sig. Ett bra exempel är information om hur man använder ditt programs API. Men kom ihåg att versionsanteckningarna i sig bör hållas på en övergripande nivå, vara kortfattade och underhållande
Många företag tar också med friskrivningsklausuler om företaget självt eller den specifika produkt som versionsanteckningarna gäller. Det är också god praxis att inkludera en e-postadress eller länk till en kontaktsida, så att kunderna vid behov kan kontakta dig angående produktens versionsanteckningar.
Exempel på versionsanteckningar för programvara
Exempel på utmärkta versionsanteckningar från ledande SaaS-företag
Slack
Slack har ett unikt sätt att hantera versionsanteckningar för programvara. Det ligger i linje med deras ”underhållande” varumärkesröst som genomsyrar marknadsföringsteamen. Anteckningarna upplevs som lättsamma, samtalstonade och underhållande. Detta skiljer sig från många företag där versionsanteckningarna för programvaran upplevs som torra och tråkiga och innehåller teknisk jargong.
De sammanfattar till och med olika delar av versionsanteckningarna för programvaran för användning i sina sociala mediekanaler, så att slutanvändarna hålls uppdaterade om vad som är nytt i Slack. Versionsanteckningar för programvara som Slacks visas vanligtvis i appbutiker.
Intercom
Intercoms sätt att hantera sina versionsanteckningar är ett av mina favoritsätt för ett SaaS-företag. Eftersom deras kunder ofta är företagsägare, från Shopify-butiker och SaaS-leverantörer till stora företag, är slutanvändarna som tar del av dessa funktionsuppdateringar vanligtvis interna team med viss teknisk kompetens.
Därför är det utmärkt att ha de senaste lanseringarna i bloggformat, med en kortfattad sammanfattning av problemet och gott om GIF:ar, skärmbilder och videor som stegvis visar en ny lansering. Det är ett bra sätt att hantera leveransen av funktionsuppdateringar och versionsanteckningar för programvara. Det här formatet för versionsanteckningar om produkter passar också utmärkt för e-postmeddelanden eller aviseringar i appen.
Ahrefs
Ahrefs använder ett liknande tillvägagångssätt som Intercom, där de har ett bloggformat för sina versionsanteckningar om produkten. Det jag vill lyfta fram här är hur de ökar användarnas medvetenhet.
De lägger till en banner högst upp på webbsidan för sin SaaS-produkt. Det är ett smart sätt att låta slutanvändarna veta vad de kan förvänta sig av nya uppdateringar. Man behöver inte förlita sig på e-postmeddelanden som kan hamna i skräppostfilter eller ett flöde i sociala medier som många användare förmodligen inte känner till.
Exempel på vad du bör undvika i versionsanteckningar för programvara
Uber
Även om jag gillar uppmaningen till slutanvändare att betygsätta Uber-appen och lämna feedback, är detta ett exempel på undermåliga versionsanteckningar för en programvaruuppdatering.
Hur förbättrades lokaliseringen, och vilka buggfixar och prestandaförbättringar gjordes? Den här appuppdateringen är vag och ger ingen konkret information om vad som kommer att ändras.
Detta är ytterligare ett exempel på halvhjärtade versionsanteckningar för programvara. En enda generisk mening ”Den senaste versionen innehåller buggfixar och prestandaförbättringar.” Den här uppdateringen ger slutanvändarna ingen uppfattning om vilka funktionsuppdateringar som kan ingå i den nya versionen eller om det finns några betydelsefulla förändringar av funktionaliteten.
More Articles
Verktyg för att sprida versionsanteckningar för programvara
Det finns många verktyg som du kan använda för att effektivisera versionsanteckningarna för en produkt. Förutom det mer traditionella tillvägagångssättet med en blogg och/eller en e-postlista för att informera om nyheter, eller sammanfattningen av appuppdateringar som du hittar i olika appbutiker.
- AnnounceKit: ”AnnounceKit hjälper företag att kommunicera produktuppdateringar och nyheter till sina kunder, öka användningen av funktioner och bygga kundernas förtroende.”
- ReleaseNotes: ”Skapa vackra och engagerande versionsanteckningar för att hålla kunder och intressenter uppdaterade, eller använd dem som ett marknadsföringsverktyg för att konvertera fler. Att publicera och marknadsföra versionsanteckningar ökar medvetenheten, engagemanget och förtroendet.”
- MagicBell: ”Aviseringsinkorgen för din produkt. Lägg till en MagicBell i din produkt för meddelanden, fakturering, arbetsflöden och andra aviseringar.”
För att förenkla processen kan du ta en titt på vår lista över verktyg för hantering av programvaruversioner.
Sammanfattning
Genom att följa dessa tips kan du skriva versionsanteckningar som är effektiva och informativa. Kunderna kommer att uppskatta den ansträngning du lägger ner på att hålla dem uppdaterade om produktförändringar.
Tack för att du läste! Har du några andra tips för att skriva versionsanteckningar? Dela dem i kommentarerna nedan! Och glöm inte att prenumerera på nyhetsbrevet!
Relaterad läsning: Livscykeln för programvaruversioner (SRLC): Förstå de 6 huvudfaserna
Relaterad verktygslista: Verktyg för hantering av programvaruversioner
Relaterad podcast: Produktprissättning: Värdebaserad strategi och programvarupaketering med Dan Balcauski
Ta en titt på detta: Programvara för idéhantering av nya produktidéer
