Glossary Updates16 new terms added to the glossaries · 12 November 2026, 21:23 CET
AI TechDocKnowledge
  • English (US)
  • English (UK)
  • Deutsch
All context cards

Context card

The role grammar: readers, writers and compilers

How do you say who does what with a piece of technical information — when “the writer”, “the machine” and “the reader” are too coarse?

By knowledge.aitechdoc.world

Reviewed

Review log and changes

The short answer

With four axes: what is done with the information (writing, deciding, compiling, using, writing back), who does it (a person, a rule-based system, an AI function or an AI agent), with which qualification and authority, and in which situation. Joined in one role sentence, they show which decision the documentation hasn’t taken yet.

For: Technical writers, technical project managers and documentation systems developers

Key points

  • A role is what someone does with the information, not a job title or a person.
  • Five activity families: writing, deciding, compiling, using, writing back.
  • The actor axis keeps people, rule-based systems, AI functions and agents apart.
  • Qualification and authority are two axes: can is not may.
  • The role sentence shows the gaps — and where the singular is enough.

The context

Why the singular isn’t always enough

The blueprints on this site speak of the writer, the machine and the reader. That is a lens: it brings one question into focus. It becomes too coarse where a decision depends on a difference it leaves out — who reads a warning, who may release a change, whether an answer function read the source or compiled a new text.

The four axes

  1. Activity — writing (creating, contributing), deciding (reviewing, releasing), compiling (passing on, assembling, translating, answering), using (reading, acting) and writing back (acting and changing a value).
  2. Actor — a person, a deterministic system, an AI function or an AI agent.
  3. Qualification and authority — established levels such as the instructed person and the skilled person, the qualified person and the competent person; authority is granted separately.
  4. Situation — first use, routine, rare task, fault, emergency, maintenance.

The role sentence

“An instructed operator uses the warning on the door interlock in routine operation and may acknowledge the fault, not bypass it.” A part that can’t be filled in is an open decision. The target audience analysis answers some of it; the role grammar keeps the answer visible in every task.

The series

The other cards of the series “Method refinement” show, one by one, where a blueprint’s singular becomes a plural.

Questions readers ask next

Does the role grammar replace the earlier blueprints?
No. They stay valid. The role grammar says where their singular has to be opened for a decision — and where it is enough.
Is the role grammar a qualification scheme?
No. It uses the qualification levels of the applicable standards and laws. Who is qualified and authorised is decided by the manufacturer and the operator.

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.