Blog

Explore our expert tips and insights on technical writing, instructional design, and process excellence by category

Insights on Technical Writing & Instructional Design | Aliso Digital Blog

Aliso Digital

The Programs I’ve Seen Fail, Failed on People

I’ve been part of digital transformation work for close to 20 years now. Some of it went well. Some of it didn’t, which is more instructive. Looking back at the ones that struggled, the causes were rarely technical. The platform usually worked. The methodology was usually sound. What went wrong

Read More »
Aliso Digital

Build the Current State Map Before the Workshop, Not During It

The default way to run a current state session is to get everyone in a room, put a blank wall in front of them, then build the map live. It’s the accepted approach. It’s also the reason process mapping workshops have the reputation they do. Three hours disappear, the loudest

Read More »
Aliso Digital

Why SMEs Trust Their Own Bad Documentation More Than Your Good One

Here’s a situation that plays out on most programs. A team has a procedure they wrote themselves. It’s a Word document, slightly out of date, structurally messy, missing the prerequisites. You produce a properly written replacement. Clear steps, verified against the system, tested, well structured, findable. Six months later they’re

Read More »
Aliso Digital

You Wouldn’t Ship Code Without Version Control. Your SOPs Have None.

Ask any engineering team how they manage change to their codebase. You’ll get a confident answer. Version control, branches, pull requests, code review, a deployment pipeline, rollback if something breaks. Every change attributable to a person, a date, a reason. Now ask the same organisation how they manage change to

Read More »
Aliso Digital

The Real Reason Nobody Deletes Old Documentation

Every knowledge base I’ve inherited has the same problem. Too much content, not too little. Hundreds of articles, several versions of the same procedure, material describing systems decommissioned years ago. Everyone agrees it needs cleaning up. Almost nobody actually does it. The interesting question is why, since the fix is

Read More »
Aliso Digital

Every Knowledge Base Has These People

Spend enough years around documentation work, you start recognising the same characters in every organisation. Different industries, different platforms, same cast. None of them are difficult people. They’re all responding sensibly to incentives nobody designed on purpose. Recognising which one you’re dealing with tends to be more useful than any

Read More »