Demonstration build

An SOP somebody actually follows

The friction in a procedure is almost never that people won't read it. It is that they can't tell which document applies, whether they're allowed to start, or whether they're finished. Those are three structural faults and all three are fixable. Below: how a library of procedures is arranged so the right one is findable, one complete SOP built the way I build them, and how I decide whether a step needs a sentence, a picture, or a video. Invented client, invented team, roles instead of names.

A page is one kind of thing. Most bad SOPs are three kinds at once.

The single most common fault I inherit is a document trying to onboard somebody new and be a fast reference for somebody who has done it forty times. It serves neither. Someone learning needs a single path with nothing unexpected. Someone working needs to jump straight to step four and find the threshold without reading. Split them, and most of the friction disappears before anyone writes a word.

Three kinds of page, and what each one is for

KindThe reader isWhat it looks likeWhat it must never do
Orientation
explains
New, or deciding whether this even applies to them One screen. What this program is, who touches it, and links to every procedure underneath it. Contain steps. The moment it does, it becomes one role's SOP and stops being shared.
Procedure
how to
At work, mid-task, probably slightly behind Numbered steps, one role per section, seven steps maximum, ending in a stated result. Teach. Assume competence and link out to the explanation for anyone who needs it.
Reference
looks up
Checking one fact and leaving A table. Thresholds, field values, turnaround times, who owns what. Live inside step seven of a procedure where nobody will find it again.

How the library is arranged

One folder per program. An orientation page at the top that holds only what is shared, and a procedure page per role underneath it. A separate reference section that every procedure links into rather than restates.

The shape matters more than it looks. Because eligibility and turnaround live on the orientation page, changing a turnaround time is one edit. Because each role has its own page, a contractor sees their procedure and not four other people's.

The rule the whole library depends on

One page owns each fact. Everything else links to it. A fact that appears on two pages is not documented twice, it is documented zero times, because the moment one copy changes the other becomes a lie that still looks authoritative. Nothing catches it. There is no cross-page diff, no "what links here", no alert.

What restating costs

A submission deadline changed by email. The role page that had helpfully repeated the date kept the old one for five days, and people worked to it, because a stale copy reads exactly like a current one.

What a pointer costs

The same page carries one line: Turnaround times are on the program overview. If that ever breaks, it breaks visibly. A stale pointer looks like a pointer. A stale copy looks authoritative.

The test I run before adding anything to a page: does this fact change for more than one role at a time, can somebody other than this page's owner change it, and would I have to write this same sentence on a second page? Any yes and it belongs somewhere else, with a link at the exact step where the reader needs it rather than dumped at the bottom.

What keeps it from rotting

Documentation does not go stale because people are careless. It goes stale because nobody owns it. Every page carries a named role and a review date on its face, not in a footer, and the review is a calendared job rather than an intention. When the work drifts from the document, the document is wrong, and the fix is a change log entry rather than a quiet edit.

And the honest part: I do not write most of these from a blank page. When a system changes, I document the change and that document becomes the SOP. When a system already exists and has never been written down, I sit with the person who does it and watch them do it, because what people describe and what people do are different documents. The gaps I find in that hour get named out loud, not filed quietly. That is usually the most valuable thing in the engagement, and it is never the thing anybody asked for.