mirror of
https://github.com/ComposioHQ/composio.git
synced 2026-09-22 11:46:35 +08:00
jkomyno
3fb74d5c98
Nightly external-link sweeps (#4205) failed on four KB URLs that are machine identifiers, not documents: Google OAuth scope URIs (googleapis.com/auth/meetings.space.*) and Ahrefs API surface roots (api.ahrefs.com/v3, the wrong-host ahrefs.com/v3). Support prose cites them bare, the KB generator copied them verbatim, and GFM autolinks published them as links that 404 by design — unfixable by pointing them anywhere. The generation layer now demotes bare citations and <url> autolinks of these identifier shapes to inline code spans, matching the convention sibling KB articles already use. Explicit markdown links keep their authored form. Regenerated the two affected guides. Verified: bun run test (506 pass), bun run lint:links, bun run lint:links:external (0 errors — the failing nightly command), bun run types:check, bun run generate:kb --check. Follow-up: docs/kb/semantic-index.json needs a rebuild with OPENAI_API_KEY (bun run build:kb-semantic) because four embedded record chunks changed.
Docs Decisions
Neutral decision records and long-running docs plans. Add every new decision record here.
Read these when a docs change touches an existing architecture, generated-data pipeline, or documented product pattern:
examples.md- cookbook/examples restructuring plan.feedback.md- feedback collection system.llm-guardrails.md- LLM guardrail injection for markdown endpoints.public-knowledge-base.md- public support publication, unified search, and Composio For You snapshot rules.toolkit-page-availability.md- docs-sync permissions, optional KB isolation, and snapshot-miss toolkit page fallback.toolkits.md- toolkit page data and rendering decisions.cookbooks-revamp-plan.md- historical cookbook revamp tracker.