Writing

Notes on running a support surface that does not embarrass you

These are about the work rather than the software: which questions are worth answering automatically, when a machine should stop and take a name, how to write help content that survives being indexed, and which numbers in this category are worth anything. Nothing here has a statistic in it, because most of the ones you see in this field were invented.

Deflection

Escalation

When an assistant should stop answering, and what has to happen next.

Help content

Writing material an assistant can answer from, and keeping it true.

Measurement

The numbers that mean something, and the popular one that does not.

Operations

Ownership, policy, launch weeks, and running one on a site nobody visits yet.

Why there is no link to this from the menu

Deliberate. The navigation at the top of the site has one job, which is to get somebody who is evaluating the product to the thing they came to evaluate. Adding a reading list to it makes that job harder for everyone and easier for nobody.

These pages are reachable from the footer of every page, from each other, and from the sitemap, which is how anybody who wants them actually arrives.

44 pieces so far.