@devries-cameron20 / composio-1 / commits / a3a2786c4
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.

docs: categorize FAQs into logical sections for easier navigation (#2903)

## Summary The FAQ page (`common-faq.mdx`) had all 32 questions in a single flat list, making it overwhelming to browse. This PR organizes them into 6 logical categories using `##` section headings, each with its own `<Accordions>` wrapper. Requested by @palash-c ([Devin session](https://app.devin.ai/sessions/acf99e3d29194f4ea9e535b5abd43e28)) ## Changes - Reorganized 32 existing FAQs from a flat list into 6 categorized sections: - **General** (5) — agent usage, tools vs toolkits, User ID, auth config vs MCP config, sessions - **Tools & Toolkits** (6) — browsing toolkits, defaults, requesting tools, versioning, triggers - **Authentication & Connections** (10) — auth configs, auth types, multiple accounts, token refresh, custom credentials, OAuth switching - **White Labeling & Branding** (4) — white labeling, logo customization, consent screens - **Debugging & Troubleshooting** (3) — masked secrets, execution logs, SDK debug logging - **Platform & Pricing** (4) — security/compliance, IP ranges, quotas, self-hosting - No FAQ content was modified — only reordered and grouped under section headings - Each category section gets its own `<Accordions>` wrapper ## Type of change - [x] Documentation ## How Has This Been Tested? - Verified all 32 original FAQ accordion blocks are preserved (no additions, deletions, or content changes) - Verified each `<Accordions>` / `</Accordions>` block is properly opened and closed per section - Relying on CI/preview deployment to confirm MDX rendering ## Checklist for human reviewer - [ ] Verify category groupings are logical — some FAQs could arguably fit in more than one section - [ ] Confirm the `## heading` + multiple `<Accordions>` pattern renders correctly in the docs site (check preview deployment) - [ ] Spot-check that no FAQ was accidentally dropped or duplicated (script confirmed 32 in → 32 out) ## Additional context The original file had FAQs in no particular order (white labeling first, then general, then auth, etc.). The new structure groups related questions together so users can quickly find the section relevant to their problem. <!-- devin-review-badge-begin --> --- <a href="https://app.devin.ai/review/composiohq/composio/pull/2903" target="_blank"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://static.devin.ai/assets/gh-open-in-devin-review-dark.svg?v=1"> <img src="https://static.devin.ai/assets/gh-open-in-devin-review-light.svg?v=1" alt="Open with Devin"> </picture> </a> <!-- devin-review-badge-end -->

Sushmitha Mallesh committed Mar 13, 2026 at 16:09 UTC a3a2786c489f66c03f257dadd18437e9883e645a

No changes.