CONTENT CREATION

Catch broken or missing docs screenshots on deploy and page on-call

After a docs deploy it loads every documented screen, flags screenshots that fail to render or 404, and pages the on-call engineer when a screen is outright broken.

CategoryContent Creation
Enginesim
Difficultyadvanced
Triggerwebhook
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerDocs deploy webhookHTTP webhook
  • ActionRead documented-screen list from ReadMeReadMeReadMe
  • ActionLoad each screen and check render via BrowserbaseBrowserbase
  • LogicSplit broken renders from drifted-but-working
  • OutputPage on-call via PagerDuty for broken screensPagerDutyPagerDuty
  • OutputFile Linear recapture tasks for drifted screensLinearLinear

What it does

This template watches for a docs deploy and then loads each documented UI screen in a headless browser to confirm the screenshot still renders — not just that it looks the same, but that it loads at all. Screens that throw, time out, or return a broken image are treated as outages and escalated to on-call, while merely-changed screens are filed as routine recapture tasks.

When to use it

Use it when a stale screenshot is annoying but a broken one is unacceptable — public docs, onboarding guides, or pages where a missing image undermines trust. It separates "recapture soon" from "fix now."

How it works

  1. 1A deploy webhook from your docs host fires the run.
  2. 2The flow reads the documented-screen list from ReadMe.
  3. 3Browserbase loads each screen and records render success, errors, and whether the embedded image resolves.
  4. 4A branch splits results: broken or missing renders versus screens that merely drifted.
  5. 5Broken screens trigger a PagerDuty incident for the on-call engineer.
  6. 6Drifted-but-working screens are filed as Linear recapture tasks.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect HTTP webhookTrigger any URL on agent actions.
  2. 2
    Connect ReadMeAPI docs, changelog, auth.
  3. 3
    Connect BrowserbaseHeadless browsers, sessions, replays.
  4. 4
    Connect PagerDutyIncidents, on-call, escalations.
  5. 5
    Connect LinearIssues, projects, cycles, triage.
  6. 6
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  7. 7
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  8. 8
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.