docs(errors): rework error pages with linked sources, drop migration framing#318
Merged
Conversation
…framing - Replace single-path `## Source` with bullet lists of GitHub-linked files plus per-file role descriptions (call site + diagnostics file). - Drop the redundant `> Package:` callout from every error page and the matching column from `docs/errors/index.md`. - Delete 20 stale DTK pages whose code now lives in devframe under DF codes (DTK0001-7, 9, 15-22, 24-27); shrink the DTK sidebar generator to an explicit list of the 12 surviving codes. - Remove all "Migrated from DTK" framing — top callouts on DF0021-28, `## Migrated from` sections on DF0001-13, the DF index column, and the comments in `devframe/.../rpc/diagnostics.ts` + `node/diagnostics.ts`. - Refresh the CLAUDE.md / AGENTS.md "Adding a new error" template to match the new format. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The `defines <CODE>` line pointing at `diagnostics.ts` added no information on top of the call-site bullet. Source now lists only the file(s) where the code is actually emitted, with multiple bullets reserved for codes that are genuinely thrown from more than one place (only DF0024 today). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
commit: |
# Conflicts: # docs/.vitepress/config.ts
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Rework all error reference pages (
docs/errors/,devframe/docs/errors/) so the## Sourcesection is genuinely useful: bullet list of GitHub-linked files (call site + diagnostics definition) with a one-line role per entry, instead of a single un-clickable backtick path. The redundant> Package:callout is dropped from every page (and from the index tables).20 stale DTK pages whose runtime emission has moved to devframe (DTK0001-7, 9, 15-22, 24-27) are deleted — they were duplicating the corresponding DF pages — and the DTK sidebar generator is shrunk to an explicit list of the 12 surviving codes.
All "Migrated from DTK" framing is removed: top callouts on DF0021-28,
## Migrated fromsections on DF0001-13, the DF index column, and the comments indevframe/.../rpc/diagnostics.tsandnode/diagnostics.ts. TheAGENTS.md/CLAUDE.md"Adding a new error" template is updated to match the new format.Linked Issues
Additional context
Net: 170 insertions / 1579 deletions across 72 files. Verified
pnpm lintclean andgit grepconfirms zero residualMigrated from DTKor> Package:hits.🤖 Generated with Claude Code