docs(roadmap): record the changes waiting on an external trigger - #67
Open
LINDECKER-Charles wants to merge 1 commit into
Open
docs(roadmap): record the changes waiting on an external trigger#67LINDECKER-Charles wants to merge 1 commit into
LINDECKER-Charles wants to merge 1 commit into
Conversation
Two migrations are decided but blocked on something outside the repo, and both were only living in a code comment: adding Node 26 to the CI matrix when it reaches Active LTS on 2026-10-28, and the TypeScript 7 port once typescript-eslint stops refusing TS 7 at load time. A comment is enough to note that something is deferred, not enough to act on later — it does not carry the trigger, the exact edits, or the reason the obvious-looking version was wrong. Each entry now names all three, so the decision is read rather than re-derived. The Node entry spells out what must NOT move with 26: engines.node, @types/node and the tsup target all track the oldest supported line, not the newest. Conflating the two is exactly what produced a @types/node PR proposing types for a runtime that was not even LTS yet. Linked from both indexes, and added to the reading-order diagram in docs/README.md so every document there stays represented.
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
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.
Adds
docs/roadmap.mdand links it from both indexes.Two migrations are already decided but blocked on something outside this repo. Until now they existed only as a comment in
ci.ymland a closed PR thread, which is enough to record that something was deferred but not enough to act on it later — a comment carries neither the trigger, nor the exact edits, nor the reason the obvious-looking version was the wrong one.@typescript-eslint/*admits TS ≥ 7.1 (#10940)The two are deliberately filed under different headings, because a calendar alone would not cover the second: TS 7 has no date. What it has is a one-command test, which the entry records so the check is not re-invented:
Each entry carries the trigger, the exact edits, the verification to run before merging, and — the part most likely to be lost — what must not change. For Node 26 that is the floor:
engines.node,@types/nodeand thetsuptarget all track the oldest supported line, never the newest. Conflating those two is precisely what produced a@types/nodePR proposing types for a runtime that was not even LTS yet, and the roadmap now states the rule instead of leaving it to be rediscovered.The TS 7 entry also preserves the measurement taken while investigating it, so the work does not get redone: the source is already TS 7 clean (
tsc --noEmiton 7.0.2 → 0 errors,tsupbuild fine), and the only blocker is the plugin throwingError: typescript-eslint does not support TS 7.0.at load — which killslintandlint:security, the security gate. That is why forcing peers is not an option.Scope: documentation only. No code, config or dependency changes.
README.mddocumentation table and thedocs/README.mdcontributor indexdocs/README.md, so every document in that index stays representedscope.md,releases/,../.github/workflows/ci.yml,../.github/dependabot.yml,../package.json)