Skip to content

docs(kernel): drop dead /docs/references/contracts link - #7338

Merged
os-help merged 1 commit into
mainfrom
claude/issue-7330-kernel-contracts-link
Aug 10, 2026
Merged

os-help merged 1 commit into
mainfrom
claude/issue-7330-kernel-contracts-link

Conversation

@os-help

@os-help os-help commented Aug 10, 2026

Copy link
Copy Markdown
Collaborator

Fixes #7330

Problem

content/docs/kernel/index.mdx linked [Contracts](/docs/references/contracts) in its "Schema reference" list. content/docs/references/contracts/ contains only meta.json — no index.mdx — because contracts publishes no JSON-Schema pages into the generated reference tree (all its schemas are unrepresentable in JSON Schema; see #7303). Fumadocs resolves a folder route from index.mdx, so /docs/references/contracts never resolved, and content/docs/references/meta.json's pages array also omits contracts, so it never appeared in the sidebar either.

Verified on origin/main before editing:

$ git ls-tree origin/main -r --name-only -- content/docs/references/contracts/
content/docs/references/contracts/meta.json

No index.mdx, confirming the premise.

Fix

Dropped [Contracts](/docs/references/contracts) from the "Schema reference" list — that list is specifically about the generated schema tree, and contracts/ publishes no schema pages into it, so dropping it loses no reachability. The real content is already linked correctly a few lines up, in the <Cards> block: <Card href="/docs/kernel/contracts" .../>.

One-line diff, hand-written docs file only. content/docs/references/** (generated by gen:docs) was not touched.

Scope

Docs-only change — no changeset; requesting the skip-changeset label at acceptance.

Verification

  • node scripts/check-nul-bytes.mjs — OK
  • pnpm check:doc-authoring — green (374 files clean)
  • pnpm check:docs-audit-scope — green (179 hand-written docs in sync, release-owned pages review-only)
  • npx eslint content/docs/kernel/index.mdx — not applicable (mdx content is outside eslint's configured scope; expected)

Generated by Claude Code

content/docs/references/contracts/ has no index.mdx (contracts publishes
no JSON-Schema pages into the generated reference tree), so the route
never resolved. The Cards section a few lines above already links the
real content correctly at /docs/kernel/contracts.

Fixes #7330

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YS2qzDAn3CpWdY7uBX9bFQ
@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectstack Ignored Ignored Aug 10, 2026 7:30am

Request Review

@github-actions github-actions Bot added size/xs documentation Improvements or additions to documentation labels Aug 10, 2026
@os-help os-help added skip-changeset PR has no user-facing published change; bypasses the changeset gate and removed documentation Improvements or additions to documentation size/xs labels Aug 10, 2026 — with Claude
@os-help
os-help marked this pull request as ready for review August 10, 2026 07:34
@os-help
os-help enabled auto-merge August 10, 2026 07:34
@os-help
os-help added this pull request to the merge queue Aug 10, 2026
Merged via the queue into main with commit 6671530 Aug 10, 2026
31 checks passed
@os-help
os-help deleted the claude/issue-7330-kernel-contracts-link branch August 10, 2026 07:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-changeset PR has no user-facing published change; bypasses the changeset gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: content/docs/kernel/index.mdx links to /docs/references/contracts, a route that does not resolve

2 participants