Blog

Your help goes out of date the day you ship

Toba

Every release changes something a user relies on. A button moves into a menu, a setting gets a new name, a form gains a step. The product is better for it. The help that described the old version is now slightly wrong, and nobody notices until a user follows it and gets lost.

Most teams accept this as the cost of shipping. Someone writes a tour, someone else writes an article, and both describe the app as it was on the day they were made. Keeping them current is everyone’s job after that, so in practice it waits until a user complains.

The teams that ship most often feel it most. A team that deploys every day can outdate its own onboarding several times a week. The faster you improve the product, the faster your help falls behind it.

Help stays current when it learns from the same place your users do: the product. If the guide reads your app again after each release, it’s never more than one deploy behind.

That’s how Skavelo works. One step at the end of your production deploy tells it to learn the app again, and it skips pages that haven’t changed, so the run is quick enough to call every time. On Starter and above it can also re-learn every week or every day.

Walkthroughs are built from the screens as they are today. Each step finds its button by its place on the page, its name and its text, so a small change usually still matches. When nothing matches well, Skavelo shows the step without pointing at the wrong thing.

Some changes are worth hearing about. Each learning run lists the screens Skavelo couldn’t reach, and the Monday summary names the walkthrough step most people stopped at, which is often a button that moved.

Learning the app also turns up parts of it that are hard to name, like an icon button with no label or a field that only has a placeholder. They confuse screen readers as much as they confuse a guide. Skavelo lists them for your developers, with a prompt they can paste into their coding assistant to fix them.

Your team will keep shipping. The help should keep up without anyone being assigned to it.

See what Skavelo would tell your users, on your own product, before you add any code.

Start free