Instructions for use... Techniques
Technical documentation enhances the product
How to write technical documents that support and enhance industrial products and services?
Instruction manuals are an essential document that supports the marketing of a product or software.
Technical Writing adapts to global trade
How to succeed in a user manual?
I recently reread part of the Council of Europe Resolution, (20 years old... 17 December 1998) on the instructions for use of technical consumer goods.
Interesting reading! A gold mine for a technical writer who may not know what to include in his manual, or his “instruction manual”, as we have “forgotten” to call these publications in the current “technically” correct vocabulary. No indication of the author of this text, but no matter, it is obvious that the author(s) were experts, well aware of the principles of minimalism. In the end, if it turns out that members of the University of Twente had participated, it would not surprise me at all.
If implementing all of these recommendations in 1998 may have seemed tedious, current content management by components systems make these principles much more accessible.
Here are a few edifying excerpts.
Instruction manuals: still useful?
Formulating usage instructions
a) Guidelines, standards, legislation, etc. concerning instruction manuals are taken into account;
b) functionality trials are carried out in order to assure that the information supplied with products is workable in practice. Therefore, in a trial of this type of device, a list of tasks to be performed and the draft instructions for use are provided to an appropriate group of consumers.They are then observed during the execution of tasks. In the end, the observations are compiled on standardized forms;
(c) the content of the instructions for use is structured on the basis of the routine operations carried out by the user on a daily basis: the content of a manual is established on the basis of the tasks which will therefore have to be performed by the users of the product.Task-oriented principle) ;
(d) the user manual provides only information which is not obvious from the product itself (a sufficiently clear mechanism that does not require any particular explanation) or from the knowledge and experience of the user, or from the characteristics of the task to be performed.Therefore Principle of the communication of necessary missing information).
This is why I don't disagree with the minimalism principles set out by John Carroll!
(Un)fortunately, who takes the time today to carry out recommended trials before developing their instruction manual?
Due to the limited lifetime of products and interfaces that are more and more ergonomic, instruction manuals are more or less useless. Yet, often it is still worth it to invest in real tests!
They can sometimes affect the products' design, and will surely have an impact on the cost of technical support for users. As for the task-orientation principle, it hasn't aged a bit.
Instruction manual: minimalism
Typical headings in this type of instruction manual are as follows:
-
list of the product versions covered by the manual, including their various features;
-
table of contents (when there are lengthy instructions),
-
brief description of the tasks that the product can perform,
-
information specific to the action undertaken relative to each task, including instructions and precautions to take related to safety, such as advice concerning installation and startup (task 1, task 2. . .), any general information related to handling precautions not already included in the description of the tasks, maintenance, as well as sections related to the detection and repair of breakdowns,
-
technical data,
-
addresses and direct customer support lines,
-
index (for products that perform several tasks, or for long instructions),
-
removable instructions related to key data (for products that carry out several tasks or consistent tasks carried out in several separate operations);
-
list of typical usage errors, their causes and possible solutions;
-
information related to ease of use of the product and methods of possible recycling;
-
information as to the availability of instructions on media other than printed paper, such as video tapes, CD-ROMs, an Internet site, etc.
Here again, we find key principles of minimalism points. Such as tasks, awareness of breakdowns and errors, table of contents and index...
It is interesting to see the equal emphasis placed on the accessibility of this type of instruction manual on other media.
Structured writing as a remedy
Separate instruction manuals for various models of the same product
Instruction manuals sometimes include information on various models or different versions of the same product. It is preferable to be able to have separate instruction manuals for each model. Especially when confusion could result in a safety issue. However, we must admit that a single manual concerns several products when the differences between the product versions do not result in a difference in activities (for example, when the version for a fax machine presents additional features on certain models, but for which the basic operations for sending a fax are the same).
And bam! Another argument in favor of structured writing systems: modularity and filtering are the two lifeblood of technical writing.
Conclusion
Facilitating the work of technical writers, solidifying the customer relationship
Through its Calenco software platform dedicated to structured technical writing, NeoDoc has been developing tailor-made solutions to facilitate, optimize and safeguard the work of technical writers for more than 12 years. The solutions are based on technical writing basics, as mentioned here, and structured writing. They place the user at the center of writing. Because facilitating access to the right information for the user also adds value to the product and solidifies the customer relationship.
