 | | | |
Increasingly technical communicators are being asked not only to write documentation and instructions, but to also teach subject matter experts how to write their own process explanations. While writing good documentation is an art, there are also formulas and templates that help guide effective process explanation. Whether instructions appear in written, verbal or digital formats, they should all observe basic conventions for graphics, layout, content organization, overviews, development of ideas, ample warnings and cautions, trouble shooting and tool lists.
View all four works by Stern, Caroline M.
View all 2240 works published by STC Proceedings |
Instructions for Giving Instructions: Creating Effective Documentation
http://www.stc.org/ConfProceed/2005/PDFs/0076.pdf
Stern, Caroline M.
STC Proceedings
2005
Abstract: Increasingly technical communicators are being asked not only to write documentation and instructions, but to also teach subject matter experts how to write their own process explanations. While writing good documentation is an art, there are also formulas and templates that help guide effective process explanation. Whether instructions appear in written, verbal or digital formats, they should all observe basic conventions for graphics, layout, content organization, overviews, development of ideas, ample warnings and cautions, trouble shooting and tool lists.
|
|
| |
There are 29 readers currently online: 1 registered user and 28 guests. Register.