@devries-cameron20 / composio Mirror · read-only / commits / b73baeeb2
Fork 0

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

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 14:30 UTC

docs: add feedback system decision document

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 19, 2026 at 15:13 UTC b73baeeb29e592a65113c1858fb7c22108ee075c
1 file changed +56
docs/.claude/decisions/feedback.md new
+56
@@ -0,0 +1,56 @@
1 +# Docs Feedback System
2 +
3 +## Decision
4 +Use Slack webhooks for collecting documentation feedback.
5 +
6 +## Why Slack?
7 +Considered options:
8 +| Option | Pros | Cons |
9 +|--------|------|------|
10 +| GitHub Issues | Public, trackable, no backend | Requires GitHub account |
11 +| Slack webhook | Instant visibility, team already there, simple | Can get noisy |
12 +| Vercel KV | On same platform | Overkill, need to build UI to view |
13 +| Email (mailto:) | Zero backend | Unstructured, easy to ignore |
14 +| Google Sheets | Easy to analyze | Need API setup |
15 +
16 +**Chose Slack** because:
17 +- Team already monitors Slack
18 +- Instant notifications
19 +- Can discuss feedback in threads
20 +- 2-minute setup (just a webhook URL)
21 +- No database to maintain
22 +
23 +## Implementation
24 +
25 +### Components
26 +- `components/feedback.tsx` - Modal UI (Geist-style)
27 +- `components/page-actions.tsx` - Contains feedback button
28 +- `app/api/feedback/route.ts` - API route that posts to Slack
29 +
30 +### Environment Variables
31 +```
32 +SLACK_FEEDBACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx/xxx/xxx
33 +```
34 +
35 +### Slack Message Format
36 +```
37 +😊 New Docs Feedback
38 +Page: /docs/quickstart
39 +Sentiment: positive
40 +Feedback: This page was really helpful!
41 +Email: user@example.com (optional)
42 +```
43 +
44 +## Setup Instructions
45 +
46 +1. Go to https://api.slack.com/apps → Create New App
47 +2. "From scratch" → Name it, select workspace
48 +3. Incoming Webhooks → Toggle ON
49 +4. Add New Webhook to Workspace → Select channel (e.g., #docs-feedback)
50 +5. Copy webhook URL
51 +6. Add to Vercel: Project Settings → Environment Variables
52 +
53 +## Future Improvements
54 +- Add rate limiting to prevent spam
55 +- Track feedback analytics (sentiment trends, common pages)
56 +- Auto-create GitHub issues for negative feedback