Skip to content

docs: improve LLM export correctness - #610

Merged
Devon-White merged 7 commits into
mainfrom
Devon/388-export-correctness
Aug 21, 2026
Merged

docs: improve LLM export correctness#610
Devon-White merged 7 commits into
mainfrom
Devon/388-export-correctness

Conversation

@Devon-White

@Devon-White Devon-White commented Aug 19, 2026

Copy link
Copy Markdown
Collaborator

Part 1 of #388.

  • adds structured LLM views for the homepage and getting-started routing
  • preserves webhook, tooltip, iframe, button, and Postman semantics in .md exports
  • adds local/manual preview semantic assertions and agent scenarios; the export checker is intentionally not wired into CI
  • documents the llms-only/llms-ignore authoring convention

Validation:

  • yarn test:scripts
  • yarn fern-md-check
  • yarn check-llm-exports after the Fern preview deploys

@github-actions

github-actions Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

hey-august
hey-august previously approved these changes Aug 20, 2026

@hey-august hey-august left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checker script is sound (soft-404 detection, presigned-URL rejection, 4xx no-retry). Manifest routes match page slugs. All homepage/getting-started llms-only links mirror pre-existing card hrefs, relay-client slug exists, and the hosted-messaging tooltip change actually fixes a dead link (buying-a-phone-number page no longer exists). The Dashboard left-nav list was verified against home/home.webp.

Note: the checker fetches all manifest routes with unbounded Promise.all (122 routes by #614); the 429-retry mitigates it, fine for a manual tool.

…ectness

# Conflicts:
#	fern/products/platform/pages/ai/get-started/capabilities/index.mdx
#	fern/products/platform/pages/ai/guides/prompt-engineering/index.mdx
#	fern/products/platform/pages/getting-started.mdx
@Devon-White
Devon-White merged commit 4bae12d into main Aug 21, 2026
2 checks passed
@Devon-White
Devon-White deleted the Devon/388-export-correctness branch August 21, 2026 18:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants