Skip to content

docs: Dead Letter Queues tutorial (closes #3092)#3099

Merged
jeremydmiller merged 1 commit into
mainfrom
docs-3092-dead-letter-tutorial
Jun 15, 2026
Merged

docs: Dead Letter Queues tutorial (closes #3092)#3099
jeremydmiller merged 1 commit into
mainfrom
docs-3092-dead-letter-tutorial

Conversation

@jeremydmiller

Copy link
Copy Markdown
Member

Closes #3092.

docs/tutorials/dead-letter-queues.md was a title-only stub, yet the tutorials index linked to it with a real description. This writes the full tutorial:

  • When a message gets dead lettered (the failure-action table; default 3 attempts).
  • A minimal setup (a throwing handler + RetryWithCooldown/MoveToErrorQueue policies).
  • Where it goes — the key distinction between the database-backed wolverine_dead_letters table and native transport DLQs (RabbitMQ/SQS/etc.), and how to opt out of native dead-lettering.
  • Inspecting/replayingdotnet run -- storage counts/replay, the SQL replayable flag, the MapDeadLettersEndpoints() REST API, and the IDeadLetters programmatic API.

All embedded code uses existing, verified snippets (sample_exponential_backoff, sample_send_to_error_queue, sample_configuring_error_handling_with_attributes, sample_disable_rabbit_mq_dead_letter_queue, sample_register_dead_letter_endpoints, sample_enabling_dead_letter_queue_expiration) hydrated via mdsnippets — no new source code. Two short inline blocks use verified APIs (store.DeadLetters, MarkDeadLetterEnvelopesAsReplayableAsync).

Found during the documentation review (#3089). Prose wording is a draft open to your edits.

🤖 Generated with Claude Code

The tutorials index linked to a title-only stub. Adds a full tutorial: when a
message gets dead lettered, the database-backed vs native-transport DLQ
distinction, and inspecting/replaying via CLI (storage replay), SQL, the REST
API, and IDeadLetters. Reuses existing verified snippets.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jeremydmiller jeremydmiller merged commit 9982f2b into main Jun 15, 2026
23 checks passed
This was referenced Jun 15, 2026
This was referenced Jun 23, 2026
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.

docs: tutorials/dead-letter-queues.md is an empty stub but linked from the tutorials index

1 participant