Skip to content

[PLT-3079] docs: add the unified eventing guide - #1146

Draft
TheMostlyGreat wants to merge 14 commits into
mainfrom
codex/unified-eventing-guide
Draft

[PLT-3079] docs: add the unified eventing guide#1146
TheMostlyGreat wants to merge 14 commits into
mainfrom
codex/unified-eventing-guide

Conversation

@TheMostlyGreat

Copy link
Copy Markdown

Why

Developers need one accurate path through triggers, schedules, retained events, and signed outgoing webhooks before eventing can ship.

What

  • adds one /build/eventing guide with the producer → event → subscription → delivery model
  • includes scoped Dashboard and REST walkthroughs for Gmail and schedules
  • documents signature verification, stable delivery IDs, retries, recovery/replay, retention, and cleanup
  • adds executable guide and Python receiver contract tests

Verification

  • pnpm vitest run tests/eventing-guide.test.ts tests/eventing-receiver.test.ts — 7/7
  • focused Ultracite check — clean
  • page-scoped Vale — 0 errors

Draft until the corresponding Engine eventing release lands.

Linear: https://linear.app/arcadedev/issue/PLT-3079

@vercel

vercel Bot commented Aug 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 29, 2026 4:31pm

Request Review

@TheMostlyGreat
TheMostlyGreat force-pushed the codex/unified-eventing-guide branch from ebe76a5 to 558d09b Compare August 29, 2026 15:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant