Skip to content

Who Did What

Source: hooks/ways/writing/ai-signs/actors/actors.md

Frontmatter
Field Value
description rewriting a report, postmortem, status update or message so each sentence names who did what with a plain verb; fix passive and agentless sentences such as it was decided and mistakes were made, things doing people's actions such as the data shows, ideas counted like objects, and log-style fragments, while labels and captions stay labels
vocabulary who did what passive voice passive constructions agentless active voice name the actor whose responsibility it was decided it has been noted mistakes were made was changed the data shows impact none completed reads like a log nominalization subject verb postmortem status update each action has a name it was determined who actually did
pattern \b(agentless|de-?nominali[sz]\w|nominali[sz]\w)\b|\bwho (did|does) what\b|\bpassive (voice|constructions?|sentences?)\b|\bmistakes were made\b|\breads? like a (log|changelog|ticket)\b
refire 0.15
scope agent, subagent

When rewriting prose so it says who acted, give each full sentence the person or team that did the thing and a plain verb. Name only people the facts give, or write "we" for the user's team. If the record does not say who acted, ask or leave the sentence passive. Do not guess a name.

Four habits to rewrite

Habit Before After
Agentless passive It was decided to roll back The on-call team decided to roll back
A thing does a person's action The data shows a delay We are two weeks behind
An idea counted like an object Data import completion stands at 90 percent We have imported 90 percent of the data
A noun or tool term used as a verb We'll action this We'll fix it this week

Do not overcorrect

  • Labels, captions, tags and headings stay labels. A margin note reads "wrong weekday" with no subject added.
  • Keep one thought in one sentence. "The draft got the weekdays wrong" beats "The draft added weekdays. They are wrong."
  • Do not credit a script, tool or source for every number. Name who did it when the reader would ask.
  • Replace a log-style fragment ("Review completed") with a noun phrase or a sentence a person would say.
  • Leave quotes and quoted drafts word for word.

See Also

  • writing/plain(writing) — naming who does what among the plain-writing rules
  • writing/ai-signs(writing) — parent: other marks of generated prose
  • trust/prose(meta) — decoration and self-explanation in long prose