Skip to content

feat(docs): rebuild documentation with the Paper design system - #9458

Closed
emir-karabeg wants to merge 1 commit into
stagingfrom
codex/docs-rebuild
Closed

emir-karabeg wants to merge 1 commit into
stagingfrom
codex/docs-rebuild

Conversation

@emir-karabeg

Copy link
Copy Markdown
Collaborator

Summary

  • Replace Fumadocs with a Sim-owned Next.js docs application and one shared component library based on the Paper designs. Add the responsive shell, reading/reference components, interaction states, and component gallery.
  • Preserve 495 authored documents, 308 API operations, existing URLs/anchors, original screenshots, workflow fixtures, and product-owned generators. One catalog powers HTML, Markdown, navigation, search, metadata, JSON discovery, and read-only MCP.
  • Move search parsing into the build and split workflow dependencies from reading pages. Measured introduction JavaScript drops from 629 KB to 236 KB compressed; the same PostgreSQL fixture's first search call drops from 4,012 ms to 15 ms, excluding module startup.

Type of Change

  • Feature / documentation architecture replacement

Testing

  • Root lint, all 26 type-check tasks, all 61 audits, root script/workspace tests, and the staging-relative block-registry check pass. Full application suite: 38,745 tests passed under Node 24.
  • Production build and migration-preservation checks pass. Real HTTP corpus: 2,995 checks. Browser: 40 checks. HTTP/MCP: 15 checks. Negotiation: 7 checks. Header merger: 16 checks. Isolated PostgreSQL: 7 checks.
  • Verification results, commands, screenshots, and limitations, architecture and authoring, and machine interfaces.
  • Live paid embedding generation and production index publication were not run. Workflow node text is server rendered; the shared canvas renderer completes measurement and painting during hydration.

Screenshots

Introduction
API reference

Rollback

Revert the replacement commit, including docs dependency and workflow changes. No database migration or product-data rollback is required. This stays in draft; no production deployment is part of this PR.

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing; new E2E checks satisfy the test-audit authoring gate
  • Lint, type checks, and repository audits pass
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

@vercel

vercel Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 29, 2026 11:11pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 6341d357 Deployed Oct 29, 2026 by vercel[bot]
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.

1 participant