Så skriver du en bra hjälpartikel

En artikel i Supportifier har två läsare: kunden i hjälpcentret och AI:n när den skriver ett utkast. Lyckligtvis vill de ha samma sak.

En fråga per artikel

Den viktigaste regeln. "Returer och byten och reklamationer" blir en artikel ingen hittar rätt i och som AI:n citerar fel del av. Tre artiklar är bättre än en.

Testet: går titeln att formulera som kundens fråga? "Hur returnerar jag en vara?" är en artikel. "Returinformation" är en samlingssida.

Svaret först

Skriv slutsatsen i första stycket, detaljerna under. Kunden som skummar får sitt svar, och AI:n som väljer ut textstycken får det viktigaste med.

❌ "Vår returpolicy har utformats med hänsyn till konsumentköplagen och…" ✅ "Du har 30 dagar på dig att returnera en oanvänd vara. Så här gör du:"

Skriv konkret

• Exakta siffror och tider: "inom 2 arbetsdagar", inte "så snart som möjligt".
• Namnge det kunden ser: knappen heter Skicka retur, så skriv Skicka retur.
• Undvik interna termer. Kunden vet inte vad "flöde B" är.

Struktur som håller

## Kort svar
En eller två meningar.

## Så gör du
1. Steg
2. Steg

## Om det inte fungerar
Vanligaste felet och vad man gör då.

Rubriker (##), listor, tabeller och kodblock fungerar — artiklarna renderas som Markdown.

Fyll i sammanfattningen

Fältet sammanfattning (excerpt) visas i listor, i sökresultat och i hjälpcentrets kategorisidor. Skriv en mening som säger vad läsaren får veta. Lämnas det tomt blir listorna ogenomträngliga.

Taggar

Lägg 2–5 taggar med kundens ord, inte era: retur, ångerrätt, skicka tillbaka, ånger. Taggarna väger in i AI:ns artikelurval, så synonymer här gör verklig nytta.

Vad som gör en artikel dålig

Håll dem levande

En artikel som är fel är sämre än ingen artikel — både kunden och AI:n tror på den. Gå igenom artikelhälsan under Kunskapsbas → Statistik med jämna mellanrum och rätta det som ger dåliga utfall. Varje ändring sparas som en revision, så det går alltid att se vad som stod förut.