Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: add feedback system decision document

Sushmithamalleshb73baeeb29e5
diff --git a/docs/.claude/decisions/feedback.md b/docs/.claude/decisions/feedback.md
new file mode 100644
index 000000000..df40337e9
--- /dev/null
+++ b/docs/.claude/decisions/feedback.md
@@ -0,0 +1,56 @@
+# Docs Feedback System
+
+## Decision
+Use Slack webhooks for collecting documentation feedback.
+
+## Why Slack?
+Considered options:
+| Option | Pros | Cons |
+|--------|------|------|
+| GitHub Issues | Public, trackable, no backend | Requires GitHub account |
+| Slack webhook | Instant visibility, team already there, simple | Can get noisy |
+| Vercel KV | On same platform | Overkill, need to build UI to view |
+| Email (mailto:) | Zero backend | Unstructured, easy to ignore |
+| Google Sheets | Easy to analyze | Need API setup |
+
+**Chose Slack** because:
+- Team already monitors Slack
+- Instant notifications
+- Can discuss feedback in threads
+- 2-minute setup (just a webhook URL)
+- No database to maintain
+
+## Implementation
+
+### Components
+- `components/feedback.tsx` - Modal UI (Geist-style)
+- `components/page-actions.tsx` - Contains feedback button
+- `app/api/feedback/route.ts` - API route that posts to Slack
+
+### Environment Variables
+```
+SLACK_FEEDBACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx/xxx/xxx
+```
+
+### Slack Message Format
+```
+😊 New Docs Feedback
+Page: /docs/quickstart
+Sentiment: positive
+Feedback: This page was really helpful!
+Email: [email protected] (optional)
+```
+
+## Setup Instructions
+
+1. Go to https://api.slack.com/apps β†’ Create New App
+2. "From scratch" β†’ Name it, select workspace
+3. Incoming Webhooks β†’ Toggle ON
+4. Add New Webhook to Workspace β†’ Select channel (e.g., #docs-feedback)
+5. Copy webhook URL
+6. Add to Vercel: Project Settings β†’ Environment Variables
+
+## Future Improvements
+- Add rate limiting to prevent spam
+- Track feedback analytics (sentiment trends, common pages)
+- Auto-create GitHub issues for negative feedback