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, 08:15 UTC
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;