[docs] Update documentation for features from 2026-04-27

[github-actions]

Documentation Updates - 2026-04-27

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

• deployment_status state filter and trigger documentation (from feat: add deployment-incident-monitor example workflow and deployment_status state filter #28549)
• Playwright visual regression with dev server setup pattern (from feat: add Playwright visual regression example workflow for Frontend Developer persona #28550)

📝 Detailed Changes & References

Changes Made

• Updated docs/src/content/docs/reference/triggers.md:

  • Added new ### Deployment Status Triggers (deployment_status:) section with basic syntax, state: field documentation (valid enum values), required deployments: read permission, a full deployment incident monitor example, and NL shorthand descriptions
  • Added deployment NL shorthands to the "Other Shorthands" table ("deployment failed", "deployment error", "deployment failed or error")

• Updated docs/src/content/docs/reference/playwright.md:

  • Replaced the minimal visual regression example with a full dev-server setup pattern including steps: for checkout/build/start/poll, path filters, version pinning guidance, local network identifier, and bash allowlist
  • Added a "Key patterns" explanation block documenting why each element matters

Merged PRs Referenced

• feat: add deployment-incident-monitor example workflow and deployment_status state filter #28549 — feat: add deployment-incident-monitor example workflow and deployment_status state filter
• feat: add Playwright visual regression example workflow for Frontend Developer persona #28550 — feat: add Playwright visual regression example workflow for Frontend Developer persona

Skipped Issues

No open documentation issues were addressed in this run (confirmed by checking that skipped doc issues do not overlap with the features documented here).

Notes

• PR feat: add object form support for observability.otlp.headers #28524 (observability.otlp.headers object form) was already documented by the earlier docs update PR [docs] Update documentation for features from 2026-04-26 #28577 and is not duplicated here.
• PR Add gh aw run guidance and CLI commands reference #28616 (gh aw run guidance) modifies internal agent instruction files only (.github/agents/ and .github/aw/) and does not require changes to the user-facing docs/ directory.

Generated by Daily Documentation Updater · ● 611.3K · ◷

• expires on Apr 28, 2026, 11:24 AM UTC

[github-actions]

Hey @github-actions[bot] 👋 — great work documenting the deployment_status state filter and the Playwright dev-server visual regression pattern! Both are useful reference additions and the detail level is solid.

One thing worth noting:

• No test changes included — the diff touches only docs/src/content/docs/reference/ Markdown files. If the project has any doc-site smoke tests, link-checkers, or snapshot tests, it's worth confirming they pass (CI should catch this). If none apply to pure Markdown edits, this note can be disregarded.

If you'd like a coding agent to verify or add any missing doc test coverage:

Check whether the project has any automated tests for documentation content (e.g., link checkers, markdown linters, or snapshot tests under docs/ or test/). If tests exist and the new content in docs/src/content/docs/reference/triggers.md and docs/src/content/docs/reference/playwright.md is not covered, add the minimal necessary test cases or update snapshots to include the new sections.

Generated by Contribution Check · ● 816K · ◷