Technical Documentation Course

Read more about the Technical Documentation course overview, prices and how to book.

Course Objectives: What Will I Learn?

Delegates who complete the Technical Documentation course will be able to:

• Understand the importance of documentation and documentation management.
• Understand the different types of documentation.
• Understand patterns for organising information.
• Implement a process for design and delivery of technical documents.
• Make informed choices as to the best digital format for documentation.
• Understand how to improve the style and readability of a document.

Intended Audience: Is This The Right Course For Me?

This course is intended for:

• The Technical Documentation course is suitable for anyone who is required to develop technical documentation, including specifications, procedures and training material.

Course Prerequisites: Am I Ready For The Course?

Previous exposure to IT systems and word-processor programs. Familiarity with web development will be an advantage.

Please ensure you meet the prerequisites for the Technical Documentation Course before you attend the course. Read the importance of course prerequisites to understand why this is necessary.

Course Contents: What Does The Course Cover?

Overview

The importance of documentation. •  Why documentation fails. •  The responsibility for documentation. •  Documentation and industry standards. •  Approaches to documentation.

Types of technical documents

Project documentation. •  System documentation: user, functional and technical specifications. •  User documentation: manuals, instructions. •  Company documentation: policies, procedures.

The Documentation Process

Using the right person for documentation. •  Identify the purpose. •  Identify the audience. •  The best time to develop the documentation. •  Planning the documentation. •  Developing documentation prototypes. •  Managing the process.

Developing the Document

Components of a document: metadata, front matter, main matter, back matter. •  Gathering information. •  Creating an outline. •  The five factors in document organisation. •  Testing for usability.

Style and Design

Formatting issues. •  Grammar and writing style. •  Learning to write clearly. •  Tables and lists. •  Diagrams and flowcharts. •  The importance of standards and styles.

Digital Formats

Advantages and disadvantages of different types of digital formats: word-processor, web, database/XML. •  Formats to avoid. •  Engineering for reuse.

Documentation Project Management

The Information Plan. •  Planning the project. •  Tracking progress. •  Project standards. •  Review and control.

Documentation Management

Defining documentation management. •  Documentation management systems. •  Revision and version control.

Download the Technical Documentation course contents in PDF format for easy printing.

Home   |    Top of this page   |    Contact Us    Schedule   |    Course List   |    FAQ   |    Sitemap

Essential Skills for IT