Context card
Where a warning belongs: safety chapter or before the task
Should a warning go into the safety chapter or directly before the step it concerns?
The short answer
Both places have a job, and they are not interchangeable. The safety chapter gives the general safety information a reader needs before using the product at all; a warning that concerns a specific hazard during a specific action belongs directly before that action, where the reader meets the hazard. A warning that only appears in the safety chapter is often not seen at the moment of action, and a warning repeated everywhere loses its meaning.
For: Technical writers, information developers and product safety engineers preparing instructions for use of machinery and equipment
Key points
- The content of a warning comes from the manufacturer’s risk assessment: which residual risks remain after design and protective measures.
- The safety chapter holds the general safety information: intended use, qualifications, general warnings, residual risks, protective equipment.
- A hazard that arises during a specific action is warned about directly before that action, in the procedure, not only in the safety chapter.
- Warnings for a whole section can open that section; a warning embedded in a step concerns that step only.
- Repeating every warning everywhere weakens all of them: readers stop reading warnings they have seen many times.
The context
Where the content of a warning comes from
A warning is not invented by the writer. Under ISO 12100, information for use is the third step of the three-step method: it addresses the residual risks that remain after inherently safe design and protective measures. Which residual risks exist, and how severe they are, follows from the risk assessment. The writer's task is to place that information where it does its work.
Two places, two jobs
The safety chapter gives the reader the safety information that applies before and across all use: intended use, required qualifications, general warnings, residual risks, protective equipment. It must not be the only place for task-specific safety controls.
A warning message about a hazard that arises in a specific action belongs directly before that action. IEC/IEEE 82079-1 asks for safety-related information to be given where the user needs it, and ANSI Z535.6 distinguishes grouped safety messages (for example in a safety chapter), section safety messages at the start of a section and embedded safety messages inside a step.
| Information | Typical place |
|---|---|
| Intended use, qualifications, general residual risks | Safety chapter |
| Hazards that apply to a whole procedure or section | At the start of that section |
| A hazard that arises in one specific step | Directly before or within that step |
Two common mistakes
- Everything in the safety chapter. The reader who opens the manual at the cleaning procedure never sees the warning about stored energy on page 4.
- Everything everywhere. When every step carries the same three warnings, the reader learns to skip warnings, including the one that matters.
In structured content
In DITA, a hazard statement can be placed inside a task step or reused across topics; the markup supports the decision but does not make it. The placement follows from the hazard and the action, not from the tool.
This card is related to risk thinking in the blueprint Thinking models for technical writers. Placing a warning correctly never makes a product safe or compliant by itself; the instructions for use of a real machine follow its risk assessment and the applicable law.
Questions readers ask next
- Does a warning in the procedure replace the safety chapter?
- No. The safety chapter gives the general safety information that applies before and across all use; warnings in procedures address hazards at the moment of a specific action. Both are needed.
- Who decides which warnings are needed?
- The content follows from the manufacturer’s risk assessment. The technical writer does not invent hazards or decide alone which risks remain, but decides together with the people responsible where and how the information is presented.
- How many warnings should a procedure have?
- As many as the hazards of that procedure require, and no more. Repeating general warnings in every step makes the specific ones harder to notice.
Sources
- ISO 12100:2010 Safety of machinery — General principles for design — Risk assessment and risk reduction — ISO, 1 November 2010
- IEC/IEEE 82079-1:2019 Preparation of information for use (instructions for use) of products — Part 1: Principles and general requirements — IEC, 8 May 2019
- ANSI Z535.6 Product Safety Information in Product Manuals, Instructions, and Other Collateral Materials — National Electrical Manufacturers Association (NEMA)
- Regulation (EU) 2023/1230 on machinery — Official Journal of the European Union, 29 June 2023
Review log and changes
Every context card is checked against its sources before it is published, and again whenever it changes; the date under the byline is the last review. Corrections (something was wrong) and additions (something was missing) are logged below with date and time (Berlin time). Typos, formatting and link fixes are not listed.
Reviewed
No corrections or additions since publication.