SlideShare a Scribd company logo
1 of 1
Understanding technical authoring

If you have ever needed to write a user/help guide, an installation and or maintenance manual, an
SOP (Standard Operating Procedure) or even a product description and troubleshooting guide then
you know what technical authoring is about. Technical authors come in various guises and can
sometimes be trainers, business analysts, managers, engineers, programmers, project managers and
administrators or health and safety representatives.

Businesses benefit from well authored technical documentation as it supports knowledge transfer
and management from the tacit to the explicit. When employees enhance their understanding of
business processes this leads to a more productive workforce that are less likely to make mistakes
and have tools at their disposal to problem-solve. Learning at a faster pace is encouraged and
therefore cost savings ensue.

Independent problem-solving also leads to less support calls allowing support services to cope with
more critical problems requiring resolution.

Assisting employees to understand and process technical documentation requires the use of
appropriate writing techniques. Writing should be clear and concise and not cluttered with
inappropriate or redundant words and grammar. Writing should be pitched appropriately at the
required target group to make it user-friendly and ensure uptake.

Best practices fortechnical authoring also include the use of technical illustrations that can assist the
reader in putting the information in context and applying it at the cold-face. The use of images
complements the text and assist readers by using visual ques. Only relevant information should be
included to allow the reader to fulfil the required outcome and not clutter their understanding with
extraneous information.

Document layout must also be carefully planned to create all the internal linkages in the text and
also to facilitate searching and quick look-ups. A comprehensive index and glossary are essential as
well as references and footnotes to other technical documentation that may be of assistance to the
reader. Exercises to assist the reader to recall information and make the concepts stick are also
helpful.

Technical authors need to stay up to date with developments in their field of expertise and may
undertake continuing professional development (CPD) courses or can also attend relevant
conferences or increase their knowledge by reading technical magazines and literature.

Reader feedback and focus group discussion can also prove to be useful. When considering the
questions that are frequently asked in relation to a particular document this can be used to revise
and edit the material for future distributions. Version control is also crucial in that readers should
only be making use of the latest versions of technical documentation to ensure that the current
thinking and approach is applied.

Technical authoring is an art and a skill and doing it effectively means improved understanding for
readers and improved performance for employees.

More Related Content

Similar to Technical Authoring

Technical Writing Training
Technical Writing TrainingTechnical Writing Training
Technical Writing TrainingTAPintellect
 
The Blueprint to Success: Best Practices for Creating Procedure Documents
The Blueprint to Success: Best Practices for Creating Procedure DocumentsThe Blueprint to Success: Best Practices for Creating Procedure Documents
The Blueprint to Success: Best Practices for Creating Procedure DocumentsTask Train
 
Best practices in Technical Writing
Best practices in Technical WritingBest practices in Technical Writing
Best practices in Technical Writingtwb_alumni
 
Empower Your Team with Technical Documentation Services.pptx
Empower Your Team with Technical Documentation Services.pptxEmpower Your Team with Technical Documentation Services.pptx
Empower Your Team with Technical Documentation Services.pptxjaya660272
 
Presentation1.update.pptx
Presentation1.update.pptxPresentation1.update.pptx
Presentation1.update.pptxsefefehunegnaw1
 
Elements of technical document
Elements of technical documentElements of technical document
Elements of technical documentMohammadFaisal170
 
five best practices for technical writing
five best practices for technical writingfive best practices for technical writing
five best practices for technical writingservicesNitor
 
Use a systematic and recursive process to create pdf.pdf
Use a systematic and recursive process to create pdf.pdfUse a systematic and recursive process to create pdf.pdf
Use a systematic and recursive process to create pdf.pdfitwkd
 
Technical Report Writing, Lagos
Technical Report Writing, LagosTechnical Report Writing, Lagos
Technical Report Writing, LagosIfeoma Onyemachi
 
Technical Writing
Technical WritingTechnical Writing
Technical Writingunknown942
 
Stc halfday tech-edit_23apr_final
Stc halfday tech-edit_23apr_finalStc halfday tech-edit_23apr_final
Stc halfday tech-edit_23apr_finalLinda Oestreich
 
Mba ebooks ! Edhole
Mba ebooks ! EdholeMba ebooks ! Edhole
Mba ebooks ! EdholeEdhole.com
 
Technical writings for academics
Technical writings for academicsTechnical writings for academics
Technical writings for academicsTapan Barui
 
How To Put Subject Matter Expert On Resume
How To Put Subject Matter Expert On ResumeHow To Put Subject Matter Expert On Resume
How To Put Subject Matter Expert On ResumeLindsay Adams
 
Technical Report Writing, Lagos
Technical Report Writing, LagosTechnical Report Writing, Lagos
Technical Report Writing, LagosIfeoma Onyemachi
 

Similar to Technical Authoring (20)

Technical Writing Training
Technical Writing TrainingTechnical Writing Training
Technical Writing Training
 
The Blueprint to Success: Best Practices for Creating Procedure Documents
The Blueprint to Success: Best Practices for Creating Procedure DocumentsThe Blueprint to Success: Best Practices for Creating Procedure Documents
The Blueprint to Success: Best Practices for Creating Procedure Documents
 
Best practices in Technical Writing
Best practices in Technical WritingBest practices in Technical Writing
Best practices in Technical Writing
 
Empower Your Team with Technical Documentation Services.pptx
Empower Your Team with Technical Documentation Services.pptxEmpower Your Team with Technical Documentation Services.pptx
Empower Your Team with Technical Documentation Services.pptx
 
Presentation1.update.pptx
Presentation1.update.pptxPresentation1.update.pptx
Presentation1.update.pptx
 
Elements of technical document
Elements of technical documentElements of technical document
Elements of technical document
 
Km Presentation
Km PresentationKm Presentation
Km Presentation
 
Km Presentation
Km PresentationKm Presentation
Km Presentation
 
five best practices for technical writing
five best practices for technical writingfive best practices for technical writing
five best practices for technical writing
 
Use a systematic and recursive process to create pdf.pdf
Use a systematic and recursive process to create pdf.pdfUse a systematic and recursive process to create pdf.pdf
Use a systematic and recursive process to create pdf.pdf
 
Technical Report Writing, Lagos
Technical Report Writing, LagosTechnical Report Writing, Lagos
Technical Report Writing, Lagos
 
Business analyst.pptx
Business analyst.pptxBusiness analyst.pptx
Business analyst.pptx
 
Technical Writing
Technical WritingTechnical Writing
Technical Writing
 
Stc halfday tech-edit_23apr_final
Stc halfday tech-edit_23apr_finalStc halfday tech-edit_23apr_final
Stc halfday tech-edit_23apr_final
 
Mba ebooks ! Edhole
Mba ebooks ! EdholeMba ebooks ! Edhole
Mba ebooks ! Edhole
 
Mba ebooks
Mba ebooksMba ebooks
Mba ebooks
 
Technical writings for academics
Technical writings for academicsTechnical writings for academics
Technical writings for academics
 
How To Put Subject Matter Expert On Resume
How To Put Subject Matter Expert On ResumeHow To Put Subject Matter Expert On Resume
How To Put Subject Matter Expert On Resume
 
Technical Report Writing, Lagos
Technical Report Writing, LagosTechnical Report Writing, Lagos
Technical Report Writing, Lagos
 
Business Analyst' Job
Business Analyst' JobBusiness Analyst' Job
Business Analyst' Job
 

Technical Authoring

  • 1. Understanding technical authoring If you have ever needed to write a user/help guide, an installation and or maintenance manual, an SOP (Standard Operating Procedure) or even a product description and troubleshooting guide then you know what technical authoring is about. Technical authors come in various guises and can sometimes be trainers, business analysts, managers, engineers, programmers, project managers and administrators or health and safety representatives. Businesses benefit from well authored technical documentation as it supports knowledge transfer and management from the tacit to the explicit. When employees enhance their understanding of business processes this leads to a more productive workforce that are less likely to make mistakes and have tools at their disposal to problem-solve. Learning at a faster pace is encouraged and therefore cost savings ensue. Independent problem-solving also leads to less support calls allowing support services to cope with more critical problems requiring resolution. Assisting employees to understand and process technical documentation requires the use of appropriate writing techniques. Writing should be clear and concise and not cluttered with inappropriate or redundant words and grammar. Writing should be pitched appropriately at the required target group to make it user-friendly and ensure uptake. Best practices fortechnical authoring also include the use of technical illustrations that can assist the reader in putting the information in context and applying it at the cold-face. The use of images complements the text and assist readers by using visual ques. Only relevant information should be included to allow the reader to fulfil the required outcome and not clutter their understanding with extraneous information. Document layout must also be carefully planned to create all the internal linkages in the text and also to facilitate searching and quick look-ups. A comprehensive index and glossary are essential as well as references and footnotes to other technical documentation that may be of assistance to the reader. Exercises to assist the reader to recall information and make the concepts stick are also helpful. Technical authors need to stay up to date with developments in their field of expertise and may undertake continuing professional development (CPD) courses or can also attend relevant conferences or increase their knowledge by reading technical magazines and literature. Reader feedback and focus group discussion can also prove to be useful. When considering the questions that are frequently asked in relation to a particular document this can be used to revise and edit the material for future distributions. Version control is also crucial in that readers should only be making use of the latest versions of technical documentation to ensure that the current thinking and approach is applied. Technical authoring is an art and a skill and doing it effectively means improved understanding for readers and improved performance for employees.