Typen technische documenten
Technisch schrijven is meer dan alleen het schrijven van handleidingen over het gebruik of de reparatie van uw TV. Het omvat verschillende soorten documenten, zelfs marketing. Lees dit artikel om meer te leren over technische documentatie; het zal nuttig zijn voor beginnende tech-schrijvers die willen beslissen welk type documentatie interessant zal zijn.
Gebruikersgidsen, handleiding, ‘How to’-gidsen en dergelijke zijn de meest voorkomende soorten technische documentatie en zij zijn degenen die altijd in de gedachten van mensen komen wanneer iemand “technische documentatie” zegt. Laat ik enkele soorten in detail beschrijven.
Gebruiksaanwijzingen
Gebruiksaanwijzingen helpen mensen een bepaald systeem te gebruiken, zoals een stuk hardware of software. Ze geven duidelijke en zinnige informatie over veelvoorkomende vragen waarmee gebruikers te maken kunnen krijgen. Gebruikersgidsen kunnen ook informatie bevatten over mogelijke storingen en manieren om deze te verhelpen. Een voorbeeld is een online help voor ClickHelp. Hierin worden functies, mogelijkheden en gebruikssituaties van dit softwaredocumentatiehulpmiddel beschreven.
Producthandleidingen
Producthandleidingen worden gemaakt om de basisbewerkingen van een product, de belangrijkste functies, algemeen onderhoud, en meer te beschrijven. Hier volgt een voorbeeld – een pagina uit een handleiding voor een polshorloge:
API Documentatie
Technische schrijvers maken API-documentatie waarin zij instructies beschrijven over hoe hardware (SCPI’s), web-API, of software-API effectief kunnen worden gebruikt. Gewoonlijk bevat API-documentatie alle informatie die nodig is om met de API te werken, details over klassen, functies, argumenten en dergelijke, ondersteund door voorbeelden en tutorials.
API-documentatie is bedoeld om klanten of gebruikers te helpen API te implementeren en te begrijpen hoe het werkt. Dit type documentatie helpt bedrijven, bijvoorbeeld, om het gemakkelijker te maken voor gebruikers om te communiceren met de code.
Om meer te leren over API-documentatie, lees dit artikel:
Science Papers, Research, and Reports
Technische schrijvers werken ook met professionals uit andere sferen, zoals geneeskunde, wetenschap, lucht- en ruimtevaart, techniek, enzovoort.
Over wetenschap en geneeskunde gesproken, onderzoekers schrijven papers met de resultaten van hun werk, maar die resultaten kunnen moeilijk uit te leggen zijn aan een breed publiek, dus vragen auteurs aan technisch schrijvers om hen te helpen hun bevindingen te interpreteren en te ordenen. Deze worden gepubliceerd in tijdschriften, en vanwege dat nauwkeurigheid en organisatie van de inhoud zijn erg belangrijk – en tech schrijvers zijn het beste voor deze job.
Technische schrijvers ook helpen ondernemers om hen te helpen rapporten te creëren, omdat duidelijkheid en nauwkeurigheid van de inhoud zijn ook vereist.