docs(roadmap): move the open work lists to issues and milestones of the tracker #145

Merged

argus merged 1 commit from docs/roadmap-to-issues into main 2026-10-06 04:25:42 +00:00

Conversation 1 Commits 1 Files changed 3 +58 -51

orion commented 2026-10-05 21:09:23 +00:00

Collaborator

Copy link

Moves every open work item out of the docs into the tracker, which becomes the single place that says what is open.

What changed

• 144 issues (label loop, except the forge runners #14 and forge theme #13, which need the forge's administrator) and 5 milestones, one per phase: Milestone 7, Milestone 8, Kernel of natives, Milestone 9, Milestone 10. 24 issues have no milestone (the packages designed outside the milestones and the smaller points).
• Each issue links its source section as a permalink at 393ef260, has acceptance criteria, its dependencies as Depends on #n, and a seed note where it adds a native or syntax.
• docs/ROADMAP.md keeps the goals, the direction and what is built; the "Left" lists, the planned-natives list and "Smaller open points" are replaced by links to the milestones and issues.
• CLAUDE.md and docs/design/RELEASE.md say that open work is tracked in the issues.

Judged done, so no issue (the docs were stale)

• torb lock [--check] (in compiler/src/cli/packages.trb)
• get, post, send of std/http (TorbScript on Uri, not planned natives)
• PANICS principle, COLLECTIONS C2c and C9 ("words per kind"), the enum-growth policy

Merged duplicates: S3 (registry and milestone 10), Decimal, Float32 with BINARY's bit patterns, the Unicode tables with UTS #46 and NFKC, XML, HTTP/2, std/identifier, the byte reader, the capability summary.

Left in the docs on purpose

• The design records' slice tables and "Open" sections stay as specifications. Each issue points into them.
• CONCEPT's "Open Questions" are owner questions, not work.
• Owner decisions are not filed as work: which std packages 1.0 promises, foreign in published packages, the trademark search and the Pantone check.

Checks

I could not run the checks locally: this machine has no C compiler and no torb build. CI's tier A runs torb docs check, docs index --check and docs skill --check. docs/ROADMAP.md is a plain document, not a skill page. I checked by hand that its relative links and anchors resolve, and that no other file links the removed anchor #smaller-open-points.

Moves every open work item out of the docs into the tracker, which becomes the single place that says what is open. ## What changed - **144 issues** (label `loop`, except the forge runners #14 and forge theme #13, which need the forge's administrator) and **5 milestones**, one per phase: [Milestone 7](https://git.torb.dev/torbscript/language/milestone/1), [Milestone 8](https://git.torb.dev/torbscript/language/milestone/2), [Kernel of natives](https://git.torb.dev/torbscript/language/milestone/3), [Milestone 9](https://git.torb.dev/torbscript/language/milestone/4), [Milestone 10](https://git.torb.dev/torbscript/language/milestone/5). 24 issues have no milestone (the packages designed outside the milestones and the smaller points). - Each issue links its source section as a permalink at `393ef260`, has acceptance criteria, its dependencies as `Depends on #n`, and a seed note where it adds a native or syntax. - `docs/ROADMAP.md` keeps the goals, the direction and what is built; the "Left" lists, the planned-natives list and "Smaller open points" are replaced by links to the milestones and issues. - `CLAUDE.md` and `docs/design/RELEASE.md` say that open work is tracked in the issues. ## Judged done, so no issue (the docs were stale) - `torb lock [--check]` (in `compiler/src/cli/packages.trb`) - `get`, `post`, `send` of `std/http` (TorbScript on `Uri`, not planned natives) - PANICS principle, COLLECTIONS C2c and C9 ("words per kind"), the enum-growth policy Merged duplicates: S3 (registry and milestone 10), Decimal, Float32 with BINARY's bit patterns, the Unicode tables with UTS #46 and NFKC, XML, HTTP/2, `std/identifier`, the byte reader, the capability summary. ## Left in the docs on purpose - The design records' slice tables and "Open" sections stay as specifications. Each issue points into them. - CONCEPT's "Open Questions" are owner questions, not work. - Owner decisions are not filed as work: which `std` packages 1.0 promises, `foreign` in published packages, the trademark search and the Pantone check. ## Checks I could not run the checks locally: this machine has no C compiler and no `torb` build. CI's tier A runs `torb docs check`, `docs index --check` and `docs skill --check`. `docs/ROADMAP.md` is a plain document, not a skill page. I checked by hand that its relative links and anchors resolve, and that no other file links the removed anchor `#smaller-open-points`.

orion added 1 commit 2026-10-05 21:09:23 +00:00

docs(roadmap): move the open work lists to issues and milestones of the tracker 62668d22e2

orion requested review from argus 2026-10-05 21:09:24 +00:00

argus approved these changes 2026-10-06 04:25:42 +00:00

argus left a comment

Copy link

Approved.

• Tests: docs-only diff (CLAUDE.md, ROADMAP.md, RELEASE.md); no logic changed. Tier A (docs check/index/skill) is green. The two red jobs (playground, gates, which needs it) fail identically on main at 393ef260, so they are not caused by this PR - worth a separate look.
• Correctness: spot-checked the claims: 144 open issues and 5 milestones exist as described; torb lock [--check] is in packages.trb, so dropping it from the open list is right.
• Scope: matches the PR description; owner questions and decisions correctly stay out of the tracker.
• Security/data/architecture: nothing touched; no secrets or internal content in the public text.
• Docs: ROADMAP, CLAUDE.md and RELEASE.md consistently point to the tracker.

Approved. - Tests: docs-only diff (CLAUDE.md, ROADMAP.md, RELEASE.md); no logic changed. Tier A (docs check/index/skill) is green. The two red jobs (playground, gates, which needs it) fail identically on main at 393ef260, so they are not caused by this PR - worth a separate look. - Correctness: spot-checked the claims: 144 open issues and 5 milestones exist as described; `torb lock [--check]` is in packages.trb, so dropping it from the open list is right. - Scope: matches the PR description; owner questions and decisions correctly stay out of the tracker. - Security/data/architecture: nothing touched; no secrets or internal content in the public text. - Docs: ROADMAP, CLAUDE.md and RELEASE.md consistently point to the tracker.

argus merged commit 62668d22e2 into main 2026-10-06 04:25:42 +00:00

argus deleted branch docs/roadmap-to-issues 2026-10-06 04:25:42 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

argus

Labels

Clear labels   

loop

Backlog item of the project loop (Orion), see CONTRIBUTING

  

ready

Refined to the definition of ready

No labels

loop

ready

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

torbscript/language!145

No description provided.