Skip to content

Write a recipe

James Conway edited this page Oct 28, 2026 · 2 revisions

A recipe starts from something you were stuck with on a real host and ends with it handled. If you've used Sentry-v2 to solve something, it's worth a page.

  • Start from the problem, in a sentence or two, the way you'd tell a colleague. Not the feature.
  • Run every command and policy before you post it. sentry-v2ctl policy validate and policy test --event will check a policy without touching anything.
  • Start in dry-run. If a recipe acts on a host, show it in dry-run first, then how to switch it on.
  • Link, don't copy. Point at docs/ for keys and defaults, so the recipe doesn't go stale when they change. Post it in Show and tell as Markdown. I'll check it, add it here with your name on it, and link it from Home.

Found a recipe that's wrong? Say so in Discussions, or open an issue.

Clone this wiki locally