-
Notifications
You must be signed in to change notification settings - Fork 2
Open
Description
Problem
The fetcher script is trying to fetch markdown from URLs like:
https://platform.claude.com/docs/en/api/kotlin/messages.md
But platform.claude.com only serves HTML pages at URLs like:
https://platform.claude.com/docs/en/api/kotlin/messages
Impact
- All API documentation updates fail
- If accidentally merged, would replace 182+ API docs with HTML 404 pages
- Users would have completely broken API integration docs
Root Cause
scripts/fetcher.py:140 adds .md suffix to platform URLs:
fetch_url = f"{url}.md"
async with session.get(fetch_url) as response:Solution Needed
The fetcher needs to distinguish between:
- code.claude.com - serves raw markdown at .md URLs ✅
- platform.claude.com - serves HTML pages, no .md URLs ❌
Either:
- Find the correct raw markdown API endpoint for platform docs
- Parse HTML content and convert to markdown
- Remove platform.claude.com docs from fetching until proper endpoint found
Closed PRs
- Closed 🚨 BROKEN API DOCS: CLI/API docs returning 404 error pages #765 to prevent catastrophic API doc breakage
💀 WHY URGENT: Would break API docs for all Claude Code users
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels