Skip to content

docs: guide for configuring override approval + Slack notifications#75

Merged
toddysm merged 3 commits into
mainfrom
docs/override-approval-guide
Jun 10, 2026
Merged

docs: guide for configuring override approval + Slack notifications#75
toddysm merged 3 commits into
mainfrom
docs/override-approval-guide

Conversation

@toddysm

@toddysm toddysm commented Jun 10, 2026

Copy link
Copy Markdown
Owner

Summary

Adds an operator-facing how-to guide for the human-in-the-loop promote-from-quarantine override path shipped in #72.

docs/guides/configuring-override-approval.md covers:

  • What the override path does (block → issue + Slack → /approve or /deny)
  • Configuring a Slack incoming webhook (and the optional GitHub Slack app)
  • Adding the SLACK_WEBHOOK and GHCR_DELETE_TOKEN repository secrets
  • Opting a per-image caller in via enable_approval: true + slack_webhook
  • The approve/deny flow, override provenance annotations, and approver permissions
  • Troubleshooting

Also links the new guide from docs/guides/README.md.

Closes #74

toddysm added 2 commits June 10, 2026 15:05
Adds docs/guides/configuring-override-approval.md, an operator-facing how-to
for enabling the human-in-the-loop promote-from-quarantine override path:
configuring a Slack incoming webhook, adding the SLACK_WEBHOOK and
GHCR_DELETE_TOKEN secrets, opting a per-image caller in via enable_approval,
the /approve and /deny flow, override provenance, approver permissions, and
troubleshooting. Links it from the guides README.

Closes #74
Copilot AI review requested due to automatic review settings June 10, 2026 22:07

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an operator-facing guide describing how to enable and operate the promote-from-quarantine human-in-the-loop override approval path, including Slack incoming webhook notifications, and links it from the guides index.

Changes:

  • Add docs/guides/configuring-override-approval.md with step-by-step setup and operational flow (/approve / /deny, required secrets, troubleshooting).
  • Link the new guide from docs/guides/README.md.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/guides/README.md Adds a link to the new override-approval + Slack notifications guide.
docs/guides/configuring-override-approval.md New operational how-to for enabling approval overrides and configuring Slack + required repo secrets.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/guides/configuring-override-approval.md Outdated
Comment thread docs/guides/configuring-override-approval.md Outdated
- remove stray backslash escape in the Slack apps autolink
- clarify the secrets prerequisite (repository administrator)
@toddysm toddysm merged commit 2f919cf into main Jun 10, 2026
3 checks passed
@toddysm toddysm deleted the docs/override-approval-guide branch June 10, 2026 23:23
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: guide for configuring the human-in-the-loop promotion override + Slack notifications

2 participants