René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"feat(lint): self-documenting diagnostics — suppression-comment hover, clickable rule docs, diagnostic tags","articleBody":"## Summary\n\nMake Rslint diagnostics self-documenting in the editor. Three capabilities, ordered by how much of the work lives in this repo:\n\n1. **Suppression-comment hover** — hovering a rule id inside `// rslint-disable-next-line no-floating-promises` shows that rule's documentation (description + link to rstack.rs). This answers \"why is this line suppressed?\" directly at the comment. Neither the ESLint nor the Biome extension offers this; Ruff proves the pattern (`ruff server` answers `textDocument/hover` over `noqa` codes).\n2. **Clickable rule ids in the Problems panel** — populate `Diagnostic.codeDescription.href` (LSP 3.16) from the rule's docs URL, so the rule id in the Problems panel links straight to the rule's page. `dbaeumer.vscode-eslint` does exactly this from `meta.docs.url`.\n3. **Diagnostic tags for dead code** — emit `DiagnosticTag.Unnecessary` for unused-variable style rules (rendered faded) and `DiagnosticTag.Deprecated` for deprecated-API rules (rendered struck-through), so squiggles stay reserved for real errors. Also proven by `vscode-eslint`.\n\n## Where the work lives\n\n| Piece | Repo | Effort |\n| --- | --- | --- |\n| Hover over disable-comment rule ids (`languages.registerHoverProvider`, derive docs URL from rule id) | this repo, client-side | 2–3 days |\n| `codeDescription.href` + `DiagnosticTag` on published diagnostics | Rslint upstream (Go LSP) | ~1 day |\n\nThe client-side hover can ship independently of the upstream half.\n\n## Constraints\n\n- `stacks/lint` is a deliberate near-verbatim copy of the upstream extension with exactly seven documented adaptations (`packages/vscode/AGENTS.md`). A client-side hover provider is new behavior, not a divergence inside the copied files — implement it as a separate module registered by the stack, and if it must touch copied files, record it as an eighth adaptation in AGENTS.md.\n- Docs URL derivation should not hardcode a URL scheme per rule; derive from one base URL + rule id, and degrade gracefully (no hover entry) for rules without docs.\n- The upstream half needs an issue/PR on web-infra-dev/rslint; link it here once filed.\n\n## References\n\n- Ruff hover over suppression codes: https://docs.astral.sh/ruff/editors/features/\n- vscode-eslint `codeDescription` / `DiagnosticTag` usage: https://github.com/microsoft/vscode-eslint\n- LSP `codeDescription`: https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#diagnostic\n","author":{"url":"https://github.com/fi3ework","@type":"Person","name":"fi3ework"},"datePublished":"2026-08-20T08:55:12Z","url":"https://github.com/rstackjs/rstack-editor/issues/27"}