Application
This unit applies to technical writers, designers, developers and support staff who are required to produce technical support documents of their work.
Technical documentation provides a record of the functionality and processing of a system, program, network or application. The technical documentation should document how the system, program, network or application is structured, how it works and changes that have been made to it.
Prerequisites
Not applicable.
Elements and Performance Criteria
1. Identify and analyse documentation requirements and client needs | 1.1 Consult with client to identify documentation requirements 1.2 Interpret and evaluate documentation requirements and confirm details with client 1.3 Investigate industry and documentation standards for requirements 1.4 Define and document the scope of work to be produced 1.5 Consult with client to validate and confirm the scope of work |
2. Design documentation | 2.1 Identify information requirements with reference to layout and document structure 2.2 Create document templates and style guides consistent with information requirements 2.3 Conduct a review of the system in order to understand its functionality 2.4 Extract content that meets information requirements according to copyright restrictions 2.5 Develop the structure of the technical documentation giving focus to the flow of information, style, tone and content format 2.6 Validate the technical documentation structure with the client |
3. Develop documentation | 3.1 Write technical documentation based on the template and scope of work using the information gathered 3.2 Translate technical terminology into plain English where appropriate 3.3 Apply content format and style according to documentation standards and templates |
4. Evaluate and edit documentation | 4.1 Submit technical documentation to appropriate person for review 4.2 Gather and analyse feedback 4.3 Incorporate alterations into the technical documentation 4.4 Edit the technical documentation for technical and grammatical accuracy |
5. Prepare documentation for publication | 5.1 Check that the completed technical documentation meets client requirements and scope of work 5.2 Submit the technical documentation to appropriate person for approval 5.3 Prepare the technical documentation for publication and distribution using appropriate channels |
Required Skills
Required skills
communication skills to interact with clients and staff
literacy skills to:
identify content
interpret standards and industry requirements
write content
research skills to:
analyse audience needs
identify target audiences
technical skills to:
determine appropriate content, formats and styles
use word-processing software and multimedia authoring tools.
Required knowledge
content features, such as clarity and readability
document design, web design and usability
functions and features of templates and style guides
instructional design principles
organisational policies, procedures and standards that cover document design.
Evidence Required
The evidence guide provides advice on assessment and must be read in conjunction with the performance criteria, required skills and knowledge, range statement and the Assessment Guidelines for the Training Package.
Overview of assessment | |
Critical aspects for assessment and evidence required to demonstrate competency in this unit | Evidence of the ability to: establish customer needs design and develop technical documentation, such as system, procedures, training material and user guides, incorporating appropriate standards update document with client feedback prepare documentation for publication. |
Context of and specific resources for assessment | Assessment must ensure access to: technical specifications documentation standards organisational resources and documentation information about system, platform, network or application being documented relevant standards appropriate word-processing software appropriate learning and assessment support when required. Where applicable, physical resources should include equipment modified for people with special needs. |
Method of assessment | A range of assessment methods should be used to assess practical skills and knowledge. The following examples are appropriate for this unit: direct observation of candidate reviewing a system to establish its functionality verbal or written questioning to assess candidate’s knowledge of copyright and other requirements relating to technical content review of technical documentation developed by candidate. |
Guidance information for assessment | Holistic assessment with other units relevant to the industry sector, workplace and job role is recommended, where appropriate. Assessment processes and techniques must be culturally appropriate, and suitable to the communication skill level, language, literacy and numeracy capacity of the candidate and the work being performed. Indigenous people and other people from a non-English speaking background may need additional support. In cases where practical assessment is used it should be combined with targeted questioning to assess required knowledge. |
Range Statement
The range statement relates to the unit of competency as a whole. It allows for different work environments and situations that may affect performance. Bold italicised wording, if used in the performance criteria, is detailed below. Essential operating conditions that may be present with training and assessment (depending on the work situation, needs of the candidate, accessibility of the item, and local industry and regional contexts) may also be included.
Client may include: | external organisations individuals internal departments internal employees. |
Requirements may refer to: | business network organisational policies people in the organisation system. |
Documentation standards may include: | audit trails International Organization for Standardization (ISO), International Electrotechnical Commission (IEC) and Australian Standards (AS) naming conventions organisational standards policy relating to: distribution revision sign-off storage project-management templates and report-writing principles version control. |
System may include: | business computers financial information management network software. |
Technical documentation may include: | brochures help references online help operational procedures reports self-paced tutorials system design system functionality system or project specifications technical manuals training materials user guides. |
Content may include: | information and interactive features: background articles company information copyright and disclaimer notices customer only information customer-specific information error messages feedback mechanisms forms frequently asked questions hyperlink titles instructions product information ratings or rankings testimonials quotes from reviews reference pages site map what's new. |
Appropriate person may include: | authorised business representative client supervisor. |
Channels may include: | animation and graphics provided through books audio CDs computer-based tutorials DVDs help screens manuals text world wide web. |
Sectors
General ICT
Employability Skills
This unit contains employability skills.
Licensing Information
No licensing, legislative, regulatory or certification requirements apply to this unit at the time of endorsement but users should confirm requirements with the relevant federal, state or territory authority.