Hur man skriver en teknisk manual från början

Anonim

Att skriva en teknisk handbok är en enkel uppgift som innebär att man organiserar steg och skapar tydlig, kortfattad formulering. Målet med en teknisk manual är att ge information om hur man utför en operation i minst steg och på det tydligaste sättet. Tekniska handböcker involverar ofta samverkan av många människor, inklusive ämnesexperter, redaktörer och tekniska författare. Eftersom tekniska manualer också kan genomgå kontinuerlig revision och uppdateringar är kommunikationen mellan de berörda parterna avgörande för utvecklingen av en manual.

Bestäm stilen i den tekniska handboken genom att antingen skapa en förenklad stilguide eller genom att följa en existerande stilguide, till exempel Microsoft Style Guide for Technical Manuals. En stilguide hjälper till att skapa handbokens skelett och säkerställa konsistens.

Skriv stegen för proceduren som börjar med ett verb. Om samråd behövs för att skriva stegen, intervju och fråga frågor om ämnesexperter. Detta säkerställer förfarandets giltighet annars kan steg inte vara logiska och / eller i ordning. Steg ska ordentligt beställas och separeras i logiska kapitel eller indelningar.

Lägg till grafik och illustrationer till steg som kräver dem. Kom ihåg att lägga till siffror och titlar till varje grafik / illustration.

Skapa en innehållsförteckning och ett index för enkel referens.

Lägg till en ändringslog eller uppdateringsblad som registrerar varje ändring och uppdatera till manualen för framtida revisioner och utgåvor. Tekniska manualer ska alltid redigeras av någon annan än den tekniska författaren, helst av en professionell redaktör.