Braindumps kan vara en guldgruva Nu kanske du som känner mig börjar undra om jag har slagit hårt i huvudet? I alla fall du som hört mig beklaga mig över
”Jag lovar, vi har gjort riskanalyser.” Ett sånt uttalande räcker inte långt vid en revision, om du inte kan visa upp dokumentationen som bevisar det. Och då kan hela projektet
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
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
Genom att utgå från user stories får du en strategi som ger dig struktur när du skriver teknisk dokumentation. Det gör att det blir lättare att arbeta agilt med din dokumentation,
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
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
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
Behöver dina kunder en lathund för er produkt? Eller behöver ni själva en intern lathund på kontoret för att komma tillrätta med reseräkningarna? Står inte det i manualen? En manual
”Det måste gå att hitta ett system för det här!” Det var mitt mantra under många år. Och hittade jag ett system, ja då ville jag illa kvickt hitta ett
Ni har en agil utvecklingsprocess. Check.Ni har kanske till och med skickat ledningen på kurs och har nu en agil organisation i stort. Toppen! Men hur står det till med
Häromveckan deltog jag i en skrivutmaning som ordnades av Sandra Muller. I fem dagar jobbade jag med att förbättra en befintlig text på engelska som jag själv hade skrivit. Det
Instruktioner finns överallt. Alla är tyvärr inte bra. Vissa är rent av omöjliga att följa. Det är onödigt, eftersom det finns gott om knep att ta till för att skriva
Distraherade läsare får sämre arbetsminne Dagens läsare är distraherade och splittrade i sin uppmärksamhet. De får därmed högst begränsade arbetsminnen. Därför behöver du hjälpa dem med att hålla den röda
Ambition räcker inte alltid Om du vill få något slags mått på hur lättläst din text är så kan du testa dess läsbarhetsindex. När jag började jobba med teknikinformation hade
Ett känt mantra inom spelindustrin är att spelen ska vara ”Easy to learn och difficult to master”, även kallat Bushnells lag. Målet är att du ska tycka att är spelet
Jobbar du på ett mjukvaruföretag? Funderar du på hur ni skulle kunna organisera och hantera er tekniska dokumentation på ett smart sätt? Då kanske konceptet Docs like code kan vara
Är inte Word helt ute som manualformat? Det finns många avancerade verktyg för teknisk dokumentation. De flesta är xml-baserade som underlättar för single-sourcing, översättning och kanske continuous delivery. Just nu
Jag älskar hacks av olika slag – knep och trick som förvandlar något svårt till något enkelt. Det kan handla om allt från att gnida paraffin på tröga byrålådor eller
Utvecklare är hårt drillade i att skriva generisk kod. Jag tycker mig se att det färgar även hur utvecklare skriver dokumentation. Men är generisk text bra? Fördelar med generisk text
Behöver du teknisk dokumentation för er mjukvara? Ta fram manualer och lathundar?
Se över policydokument?
Jag hjälper dig med metoder, kunskap och erfarenheter kring produktdokumentation så att den blir både effektiv och användbar.
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.
