Skriv effektive produktudgivelsesnoter (+ virkelige eksempler og skabeloner)

Alle, der beskæftiger sig med at skrive produktudgivelsesnoter, finder dem kedelige, kedelige og tidskrævende. Man ser ofte folk bogstaveligt talt løbe væk fra dem. Men husk på, at det er vigtigt at udgive produktudgivelsesnoter og holde din changelog opdateret for at sikre din virksomheds vækst. I denne artikel vil vi også se på skabeloner til udgivelsesnoter.

Siden af at køre en changelog-tjeneste, beskæftiger vi os også meget ofte med udgivelsesnoter. Vi bliver ved med at opdatere vores brugere om de seneste ændringer forbedringer, som vi har foretaget på vores produkt. Derfor har vi udviklet teknikker til, hvordan vi kan gøre hele processen mere udholdelig og effektiv.

Hvad er release notes?

Release notes er et dokument i punktform, der kommer sammen med en softwareudgivelse for at fortælle brugerne, hvad der er ændret. Selv om der ikke findes noget universelt format, indeholder typiske release notes oplysninger om fejlrettelser, nye funktioner og undertiden kendte problemer. Udgivelsesnoter kan være et kedeligt teknisk dokument, som ingen bryder sig om at læse og skrive. Men vores mission som produktchef, er at gøre til disse noter mere tiltalende, interessante og informative.

Hvad er problemet med dem?

Tre hovedproblemer forbundet med release notes er
– ledelse,
– brudt kommunikation,
– og en distributionskanal.

Det største problem vi står overfor er manglende kommunikation i teamet. Selv i små virksomheder har det tekniske team svært ved at forklare, hvad der er blevet ændret. Ofte retter de noget, og et par uger senere glemmer de også, hvad der blev gjort i denne måned.
Jamen, og det er også en fejl at overlade opgaven med release notes til udviklingsteamet. De har en tendens til at skrive meget tekniske release notes til folk med en ph.d. i datalogi.
Læsere er ligeglade med, hvordan noget blev rettet; de er kun interesseret i det endelige resultat. Hvordan kan de få gavn af opdateringen?

Tips til at skrive udgivelsesnoter (med skabeloner)

Hvis vi ser bort fra emnet humor i udgivelsesnoter til senere, kan de fleste oplysninger i udgivelsesnoter skabelones til en forståelig form. Så næste gang en udvikler sender dig noter om en rettet fejl eller en ny funktion, vil I begge spare tid.
Så i stedet for at modtage en kommentar fra en udvikler, der ikke giver nogen mening. Du vil have en dybere forståelse af, hvad der er ændret, og hvordan du bedre kan kommunikere det til slutbrugerne.
Så, her kommer vi til min personlige liste over tips og tricks, som jeg bruger til at lave gode release notes! Bliv inspireret og skriv dine egne skabeloner til produktrelease notes!. Skabeloner til softwareproduktreleasenoter er en god måde at spare tid på.

1. De > Vi

Lad være med at starte med “Vi har gjort dette”. Brugerne er ligeglade med, hvad DU har gjort, de er kun interesseret i, hvad DE får ud af det, du har gjort.

Du kan nu .
Nyligt udgivet er tilgængelig til dit brug. Nu vil du kunne

2. Fokuser på brugeren

Brug “DU” oftere. Det er et copywriting-trick, der øjeblikkeligt forandrer den måde, tekstinformationerne opfattes på. De vil ubevidst være mere tilbøjelige til at læse teksten, når de ser “du”.

Godt nyt til dig! lader dig indsamle dig feedback fra dine brugere.
Glad med at meddele, som hjælper dig med at undgå tab af data.
Spar din tid med

3. Følg enkle skabeloner for udgivelsesnoter

Opret disse skabeloner og bed jer, udviklere, om at skrive jer noter udelukkende i dette format. På den måde undgår I misforståelser, og I vil vide præcis, hvad der er ændret, hvordan det fungerer, og hvilke mål det forsøger at opnå. Alene disse 4 skabeloner dækker 90 % af alle release notes.

• Tidligere X er nu Y
• Du kan nu gøre X i stedet for Y
• X gør ikke længere X, Y når Z, Q, W
• X gør ikke længere Y. Det betyder, at du ikke længere behøver at gøre Z

4. Undgå at være for formel

Det afhænger naturligvis af din virksomheds branding. Men formel skrift er normalt lang og ikke lige til sagen. Så det gør det sværere for læserne at scanne teksten. Prøv at bruge et konsekvent sprog og undgå at være for formel på dine dokumentskabeloner til release notes.

5. Udvid og forenkl derefter

Gode release notes er korte og præcise. Men for at nå dertil skal du udvide teksten og sørge for, at den afspejler alt det, som en ny funktion, en fejlrettelse handler om. Desuden består meget af det at skrive release notes i at tage en stor mængde information og presse den ind i korte afsnit. Sørg for, at de enkelte release notes ikke bliver taget ud af kontekst.

Lad os se på de bedste eksempler på release notes. 3 virksomheder med gode Release Notes-sider, og hvordan kan du lære af dem?

👉Relateret artikel: Alt du behøver at vide om nøgletal i SaaS

Eksempler på release notes

Salesforce Release Notes Eksempler

Salesforce er en CRM-platform med mange produkter under deres paraply. Så at holde kunderne opdateret om nye funktioner og produktændringer er et helvede for tekniske skribenter, produktchefer og udviklere.
Jeg går ud fra, at virksomheden udarbejder release notes hvert kvartal og hedder “Salesforce Summer ’19 Release Notes”, som er en meget omfattende release notes-side med sine kategorier og underkategorier.
Salesforce release notes er en blanding af almindelige release notes samt produktkort. Det er en detaljeret forklaring på, hvordan hver enkelt funktion kommer til at fungere, og specifikt for hvilke brugere de vil være tilgængelige.

Den åbenlyse fordel ved sådanne omfattende release notes-sider er at tage arbejde fra supportafdelingernes skuldre. Hvis de f.eks. modtager et kundespørgsmål i forbindelse med et specifikt emne. De kan nemt videresende dem til siden, hvor brugerne kan finde svaret.

Nøgleproffetips til at tage ud:

1. Sådan bruges afsnittet med udgivelsesbemærkninger

2. Detaljerede, visuelt forståelige tabeller med en produktkøreplan

3. Filterafsnit

4. Generaliseret forklaring, generaliseret forklaring og derefter efterfulgt af en detaljeret beskrivelse af, hvordan en ny funktion fungerer.

Salesforce følger også skabeloner til udgivelsesnoter.

Strin 1: Forklar, hvad den nye funktion handler om.
Du behøver ikke længere at skifte til Salesforce Classic for at administrere områdetildelinger på siden Konto. Du kan nu redigere den tilknyttede liste over tildelte territorier i Lightning Experience. Tidligere var den relaterede liste skrivebeskyttet i Lightning Experience.

Du behøver ikke længere at udføre . Du kan nu udføre . Tidligere kunne du kun udføre .

Stræk 2: Forklar, hvordan du aktiverer eller får adgang til funktionen
Hvor: Denne ændring gælder for Lightning Experience i Performance- og Developer-udgaverne og Enterprise- og Unlimited-udgaverne med Sales Cloud.

Stræk 3: Forklar, hvordan du bruger funktionen
Hvordan: Hvis dit kontosidelayout indeholder den relaterede liste Tildelte områder, er det ikke nødvendigt med nogen opsætning. Klik på Assign Territories og tildel for at administrere tildelinger.

Sketch Release Notes Examples

Hvis dit produkt ikke er så kompliceret og ikke er en platform med en stor paraply af underværktøjer, kan du tjekke Sketch company.
Layoutet er interessant. I højre side har du en detaljeret beskrivelse af alle nye funktioner og fejlrettelser, og i venstre side er der beskrivelser af de vigtigste store funktioner. Og CTA.

Smart Distribute Upgrades

Du kan nu bruge Smart Distribute til at styre mellemrummene i gitter. Du kan nemt justere den lodrette afstand mellem rækker af lag samt den vandrette afstand mellem hvert enkelt lag i en række. Vi har også indført en ny knap “Ryd op” i inspektøren. Den justerer hurtigt et udvalg af flere lag i et pænt gitter, hvilket gør det endnu nemmere at oprette og administrere komplekse layouts.

Igen ser vi en simpel skabelon:
Du kan nu gøre . Du kan nemt gøre . Vi har også indført en ny .

I forbedringer:
Vi har tilføjet en ny kommando Vælg alt i Artboard til menuen Rediger, så du hurtigt kan få fat i alle lagene på et Artboard, du har valgt. Vi har også givet de forskellige Vælg alt-kommandoer deres egen undermenu.

• Vi har tilføjet , så du nu kan gøre .
• Fiksede et nedbrud, der kunne opstå, når du forsøger at trække-at-vælge med Magic Wand-værktøjet.
• Fiksede en fejl, hvor den korrekte typevægt ikke blev vist for skrifttyper med samme navn.

– Rettet en fejl i listerne Sider og Lag, hvor markeringer ikke blev fremhævet korrekt, når der var tilsluttet en ekstern skærm.

Så, for at vende tilbage til brugerorienterede udgivelsesnoter, skal vi forstå, at vi skriver vores udgivelsesnoter til vores målgruppe. Salesforce skriver deres udgivelser til folk uden teknisk baggrund, til salgsafdelinger og marketingfolk, iværksættere, grundlæggere osv.

Skitsen bruges af grafiske designere og kunstnere. Således bruger både Salesforce og Sketch en generisk tone, meget brugervenlig, orienteret mod rigtige mennesker.

Getpostman Release Notes Eksempler

Hvis dit produkt er teknisk, og dine brugere er udviklere, så er det modsatte en tommelfingerregel. Jo kortere, mere teknisk og ikke visuelt tiltalende, jo bedre er det.

For eksempel er Getpostman et teknisk produkt for udviklere.

Release Notes kan hurtigt scannes igennem for at få en generisk idé om, hvad der er nyt. Og det følger et meget forenklet format.

Opdateringsnummer, dato og oplysninger i én sætning om hver opdatering uden detaljer om, hvad det betyder for en bruger, hvordan man bruger det eller hvordan man får adgang til det.

Desto enklere jo bedre. De vil forstå det.

Humor i udgivelsesnoter

Vi har allerede talt om eksempler på udgivelsesnoter i apps, der er morsomme og underholdende at læse. Tonen er dog ikke egnet til de fleste teknologivirksomheder. Og de har brug for en stilguide for release notes. Desuden har ikke alle softwareprodukter en mobilversion, og de fleste virksomheder offentliggør deres release notes på en separat side et sted under support- eller hjælpesektionen. (Virksomhederne begraver strategisk deres release notes og klager derefter over, at ingen læser dem.)

Der er mange smarte måder at annoncere produktopdateringer på. For eksempel ved at skrive en god e-mail for at introducere produktopdateringer eller oprette et separat blogindlæg.

👉 Relateret artikel:

Som i alt andet i livet, ved at bringe struktur og organisation samt moderne teknologier skaber vi en nemmere løsning, der ikke er så kedelig og unødvendig.

Håbenligt har vores eksempler på software release notes skabeloner
og eksempler hjulpet dig.