Agil dokumentation – en oxymoron?

Blixttal på Agila Sverige

Är ”agil dokumentation” är en motsägelse i sig själv? Den frågan ställde jag mig i ett blixttal som jag höll på konferensen Agila Sverige i maj 2019. (Skrolla ner om du vill se videon).

Kan dokumentation vara agil? Hur uppnår vi i så fall det?

Bakgrunden till mitt tal

Mitt intryck är att det finns relativt få teknikinformatörer på mjukvaruföretag, framför allt bland de mindre företagen. Det finns säkert många orsaker till det, men jag tror att en faktor är att det inte har funnits så mycket regulatoriska krav när det gäller mjukvara. Systematisk dokumentation har då varit ”nice to have” snarare än ”need to have”. I valet mellan att anställa ytterligare en utvecklare eller att ta in en teknisk skribent så har det känts rimligt att satsa på att hinna få fram fler efterlängtade funktioner snarare än att komma ikapp med dokumentationen. Fullt förståeligt.

Men situationen håller på att ändras. Förra året kom GDPR. Medicinteknisk mjukvara behöver CE-märkas och i många upphandlingar i offentlig sektor ställs krav både på att leverera teknisk dokumentation och att uppfylla kraven i ISO 27000-serien för informationssäkerhet. En systematisk och ändamålsenlig produktdokumentation kan också vara nödvändigt för att kunna skala upp verksamheten.

Utveckla metoderna för teknisk dokumentation

Är du en av dem som tänker att det är dags att ta tag i dokumentationen? Jag kan tänka mig att det inte är så lätt att veta i vilken ände du ska börja. Jag tror dessutom att många mjukvaruföretag inte ens vet att det finns en yrkesgrupp som har teknikinformation som profession. Att det finns någon som kan hjälpa er att gå i rätt riktning och leda er förbi de värsta fallgroparna. Därför ville jag prata om hur dokumentationen också, precis som utvecklingsmetoderna, kan utvecklas och bli mer agil.

Vill du veta vad jag sade? Titta på videon nedan! Den är knappt 10 minuter.

 

Jag hjälper dig med metoder, kunskap och erfarenheter kring produktdokumentation så att den blir både effektiv och användbar.

Fler inlägg

Elbil

Läsa, förstå och komma ihåg?

Jag fattar inte varför vår elbil inte har växlar, jag erkänner. Förut tänkte jag att den var automatväxlad, men vet numera att så inte är fallet. Den har helt enkelt

Buffe med mat

Därför ska du skriva manualen som en buffé

Jag är en förespråkare av modulär teknisk dokumentation. Varför? För att det gör dokumentationen lättare att använda, lättare att skriva och framför allt lättare att uppdatera. Hur då? Modulärt julbord

Instruktioner för att laga soppa

User stories ger dig rätt instruktioner (del 2)

User stories visar vad er produkt faktiskt ska uträtta åt användaren. Eller snarare vad användaren vill göra. Du kan nu enkelt förstå vilka instruktioner som du behöver skriva. Välkommen till

Läsare av teknisk dokumentation

Fixa dokumentationen med user stories (del 1)

User stories kan ge dig en flygande start när du ska skriva teknisk dokumentation, särskilt manualer av olika slag. Det gäller oavsett om det är grundläggande manualer till slutanvändare, integrationsinstruktioner

Musfälla

Trick för att locka information ur utvecklare

Att få fram underlag till teknisk dokumentation är verkligen en utmaning. Själv har jag provat allt. Jag har mutat utvecklare med kakor. Intervjuat stressade projektledare. Filtrerat ofantliga mängder med utvecklingsärenden

Gunilla Svanfeldt Omslag

Samtycke till marknadsföring

Vi lagrar informationen som du anger i formuläret för att kunna kontakta dig med nyhetsbrev, om uppdateringar och med erbjudanden. 

Markera kryssrutan i formuläret för att ge ditt samtycke till att vi skickar e-post till dig.

We use MailerLite as our marketing automation platform. By clicking below to submit this form, you acknowledge that the information you provide will be transferred to MailerLite for processing in accordance with their Privacy Policy and Terms of Service.