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

refactor: move toolkit FAQ files to content/toolkits/faq/

Moves FAQ markdown files from content/toolkit-faq/ into content/toolkits/faq/ so they live alongside other toolkit content. The link checker now scans all .md files under content/ generically instead of special-casing the FAQ directory. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmithamallesh committed Feb 17, 2026 at 19:50 UTC 47cc1ef1f7144606c6d23a789ca61c0ee9c89d8b
49 files changed +13 -23
docs/.claude/decisions/toolkits.md
+2 -2
@@ -195,7 +195,7 @@ Run: `bun run generate:toolkits`
195 ## FAQ Section
196
197 ### How It Works
198 -- Per-toolkit FAQ sourced from plain markdown files in `content/toolkit-faq/{toolkit-slug}.md`
198 +- Per-toolkit FAQ sourced from plain markdown files in `content/toolkits/faq/{toolkit-slug}.md`
199 - `##` headings are questions, body text is the answer
200 - Markdown is converted to HTML at build time using `remark-parse` + `remark-rehype` + `hast-util-to-html` (all transitive deps from Fumadocs, no new packages)
201 - Rendered as Fumadocs `Accordion` components between the Header and Auth Details sections
@@ -210,7 +210,7 @@ Run: `bun run generate:toolkits`
210 - No changes to sitemap or routing
211
212 ### Adding FAQ Content
213 -- Create/edit `content/toolkit-faq/{toolkit-slug}.md` — no code changes needed
213 +- Create/edit `content/toolkits/faq/{toolkit-slug}.md` — no code changes needed
214 - Empty files or files with no valid `##` headings are safely ignored
215
216 ---
docs/app/(home)/toolkits/[[...slug]]/page.tsx
+1 -1
@@ -108,7 +108,7 @@ function markdownToHtml(md: string): string {
108 }
109
110 async function readToolkitFaq(slug: string): Promise<FaqItem[] | null> {
111 - const filePath = join(process.cwd(), 'content/toolkit-faq', `${slug}.md`);
111 + const filePath = join(process.cwd(), 'content/toolkits/faq', `${slug}.md`);
112 let content: string;
113 try {
114 content = await readFile(filePath, 'utf-8');
docs/app/llms.mdx/[[...slug]]/route.ts
+1 -1
@@ -608,7 +608,7 @@ function renderParamsMarkdown(params: Record<string, ParameterSchema>): string[]
608 // Read FAQ markdown for a toolkit (returns raw markdown or null)
609 async function readToolkitFaqMarkdown(slug: string): Promise<string | null> {
610 try {
611 - const filePath = join(process.cwd(), 'content/toolkit-faq', `${slug}.md`);
611 + const filePath = join(process.cwd(), 'content/toolkits/faq', `${slug}.md`);
612 return await readFile(filePath, 'utf-8');
613 } catch {
614 return null;
docs/content/toolkits/faq/airtable.md renamed
docs/content/toolkits/faq/asana.md renamed
docs/content/toolkits/faq/calendly.md renamed
docs/content/toolkits/faq/canva.md renamed
docs/content/toolkits/faq/confluence.md renamed
docs/content/toolkits/faq/dropbox.md renamed
docs/content/toolkits/faq/facebook.md renamed
docs/content/toolkits/faq/gitlab.md renamed
docs/content/toolkits/faq/gmail.md renamed
docs/content/toolkits/faq/google_admin.md renamed
docs/content/toolkits/faq/google_classroom.md renamed
docs/content/toolkits/faq/google_maps.md renamed
docs/content/toolkits/faq/googlecalendar.md renamed
docs/content/toolkits/faq/googledocs.md renamed
docs/content/toolkits/faq/googledrive.md renamed
docs/content/toolkits/faq/googlemeet.md renamed
docs/content/toolkits/faq/googlesheets.md renamed
docs/content/toolkits/faq/googleslides.md renamed
docs/content/toolkits/faq/googlesuper.md renamed
docs/content/toolkits/faq/googletasks.md renamed
docs/content/toolkits/faq/hubspot.md renamed
docs/content/toolkits/faq/instantly.md renamed
docs/content/toolkits/faq/jira.md renamed
docs/content/toolkits/faq/linkedin.md renamed
docs/content/toolkits/faq/monday.md renamed
docs/content/toolkits/faq/notion.md renamed
docs/content/toolkits/faq/one_drive.md renamed
docs/content/toolkits/faq/outlook.md renamed
docs/content/toolkits/faq/pipedrive.md renamed
docs/content/toolkits/faq/posthog.md renamed
docs/content/toolkits/faq/quickbooks.md renamed
docs/content/toolkits/faq/salesforce.md renamed
docs/content/toolkits/faq/shopify.md renamed
docs/content/toolkits/faq/slack.md renamed
docs/content/toolkits/faq/snowflake.md renamed
docs/content/toolkits/faq/spotify.md renamed
docs/content/toolkits/faq/strava.md renamed
docs/content/toolkits/faq/stripe.md renamed
docs/content/toolkits/faq/twitter.md renamed
docs/content/toolkits/faq/whatsapp.md renamed
docs/content/toolkits/faq/xero.md renamed
docs/content/toolkits/faq/youtube.md renamed
docs/content/toolkits/faq/zendesk.md renamed
docs/content/toolkits/faq/zoho.md renamed
docs/content/toolkits/faq/zoom.md renamed
docs/scripts/validate-links.ts
+9 -19
@@ -1,5 +1,5 @@
1 -import { readdir, readFile } from 'node:fs/promises';
2 -import { join } from 'node:path';
1 +import { readFile } from 'node:fs/promises';
2 +import { glob } from 'node:fs/promises';
3 import {
4 type FileObject,
5 printErrors,
@@ -152,23 +152,13 @@ async function getFiles(): Promise<FileObject[]> {
152 }
153 }
154
155 - // Toolkit FAQ files (embedded snippets not in any Fumadocs source)
156 - const faqDir = join(process.cwd(), 'content/toolkit-faq');
157 - try {
158 - const faqFiles = await readdir(faqDir);
159 - for (const file of faqFiles) {
160 - if (!file.endsWith('.md')) continue;
161 - const filePath = join(faqDir, file);
162 - const content = await readFile(filePath, 'utf-8');
163 - const slug = file.replace(/\.md$/, '');
164 - allFiles.push({
165 - path: filePath,
166 - content,
167 - url: `/toolkits/${slug}`,
168 - });
169 - }
170 - } catch {
171 - // toolkit-faq directory doesn't exist, skip
155 + // Scan any .md files under content/ not already covered by Fumadocs sources
156 + const coveredPaths = new Set(allFiles.map((f) => f.path));
157 + const extraMdFiles = await Array.fromAsync(glob('content/**/*.md'));
158 + for (const filePath of extraMdFiles) {
159 + if (coveredPaths.has(filePath)) continue;
160 + const content = await readFile(filePath, 'utf-8');
161 + allFiles.push({ path: filePath, content });
162 }
163
164 return allFiles;