Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: add feedback system decision document
Sushmithamalleshb73baeeb29e5
diff --git a/docs/.claude/decisions/feedback.md b/docs/.claude/decisions/feedback.mdnew file mode 100644index 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