Technical Documentation
Document creation can take many different forms and in some cases take on a life of their own. Experience has shown us that a ‘one size fits all’ approach is not always applicable so our process follows a typical example of the document creation cycle.When there are no existing documents, we start from the beginning and formulate a baseline for creation.These are the basic steps:
Requirements Definition:
Requirements Definition:
Determine the type of documentation required and the best style and format.
- Policy and Procedure
- 'How To' Manual
- Functional Specification
- Technical Specification
- User Guide
- Program Specification
- System Specification
- White Paper
- Newsletter
- Brochure
- Presentation
- Data Gathering:
Conduct interviews of SMEs where necessary and compile operational notes. Organize and create a working text for review.
For an illustrated example of our documentation approach, see Crafting a Document
- Illustrations and diagrams:
Complex concepts and system depictions can be visually narrated with the use of such tools as:- Visio
- Illustrator
- Photoshop
- Fireworks
- Powerpoint
- Review Process:
Electronic routing is a proven method for facilitating the review and feedback of all concerned parties. - Sign-off
- Users should be involved in every phase of the process to ensure signoff.