Anyone Can Learn BPMN 2.0, Not Everyone Can Lead the Team Using It
You can teach BPMN 2.0 to a competent graduate in a fortnight. Tasks, gateways, events, pools, lanes. Give them 3 months on a real program, they’ll be modelling processes as well as anyone. The notation was never the scarce skill. What’s scarce is someone who can take a group of analysts with that same notation, […]
“We’ll Document It After Go Live”
There’s always someone arguing documentation can wait until after go live. The logic is hard to fault in a planning meeting. The system isn’t finished. Screens are still changing. Why write procedures against something that’ll look different in 6 weeks. Then go live arrives, the team moves onto the next release, the documentation never gets […]
Same Road, Different Technology
There’s always someone announcing that AI writing is slop. Usually in a comment, usually with some variation of “you can always tell”. I read a lot of those. What strikes me isn’t the argument, since the argument is mostly aesthetic. It’s how familiar the shape of it is. Every significant tool change gets the same […]
The Requirements Are in the Conversation, Not the Document
Ask most people what a business analyst does and you’ll get an answer about documentation. Writing specs, keeping the traceability matrix current, running things through a change control process. That’s the visible part. The part that actually determines whether a program lands is much less visible, which is sitting with people until you understand their […]
What Makes a Work Instruction People Actually Use
Most organisations have plenty of documentation. What they don’t have is documentation anyone opens twice. The difference between a work instruction that gets used, versus one that gets written then forgotten, usually comes down to a handful of decisions made before anyone starts typing. Here’s what those decisions look like, plus how to use AI […]
Technical Writers Are Paid to Notice What’s Missing
There’s a moment in most documentation jobs where an engineer explains something clearly, completely, in a way that makes total sense. You take notes, you thank them, you go to write it up. Then halfway through the third step you stop. What happens if the user doesn’t have that permission? Nothing in the notes covers […]
Yes, AI Helped Write This. I’ve Been a Technical Writer for 20 Years.
Let’s get the objection out of the way first. Yes, AI helped produce this article. I’ve been a technical writer on and off for nearly 20 years. Government, healthcare, finance, aviation, telecommunications. I use these tools daily. I use them deliberately, without guilt. The argument against doing so doesn’t hold up well, so it’s worth […]
The Time AI Gives Back to a Technical Writer
Every technical writing job has a set of tasks that sit between you, the actual writing. Building an outline. Working out what’s missing from a documentation set. Putting together an example so a concept lands. Editing the same document for the fifth time. None of that is the hard part of the job, though collectively […]
4 Things AI Genuinely Does Well in Technical Writing
There’s a lot of noise about AI in documentation work. Some of it oversells what the tools do, some of it dismisses them entirely. The reality sits in the middle, which is less interesting to write about, though more useful. After a couple of years using these tools daily across rollouts, 4 things stand out […]