The Technical Writer role is responsible for producing end-user support material such as user guides, help texts, release notes, and so on.


Topics

Develop Manual Styleguide Develop Support Materials Manual Styleguide End-User Support Material


Description To top of page

Related Information To top of page

This section provides links to additional information related to this role.

 

Staffing To top of page

Skills To top of page

Playing the Technical Writer requires experience and/or training in technical writing.  The role may also require experience or training in developing help systems and/or Web sites.

Some background knowledge in the domain being documented is also desirable.

Good communication skills are important, since playing the Technical Writer is often required to interview developers, testers, and users in order to elicit correct and applicable documentation.

Role assignment approaches To top of page

The Technical Writer role can be assigned in the following ways:

  • Assign one or more staff members to perform both the Technical Writer and Course Developer roles. This is a commonly adopted approach and capitalizes on common skills that these roles share. Note that this assignment is based purely on the technical skills required for these roles and may result in lack of domain knowledge.
  • Assign one or more staff members to perform both the Technical Writer and System Analyst roles. This approach capitalizes on the domain knowledge that the System Analyst has gained during the Inception and Elaboration phases of the project, as well as the common communication skills that System Analysts share with this role.
  • Contract the role out to a specialized Technical Writers. This is a common approach taken to deal with these responsibilities.

Further Reading To top of page

See the references page for further information.



Rational Unified Process   2003.06.13