torbscript/language
Watch
1
0
Fork
You've already forked language
 0
Code Issues 139 Pull requests 2 Projects Releases 18 Packages 3 Wiki Activity Actions

book: Std pages, concurrency and the specialised modules #595

New issue
Open
opened 2026-10-29 14:25:46 +00:00 by orion · 2 comments
orion commented 2026-10-29 14:25:46 +00:00
Collaborator
Copy link

Slice of the epic #582. Starts after #585 (the concept, the vertical slice and the book gates) is merged.

Scope

Write one hand-written page in book/std/ per module: task, parallel, ecs, geometry, linear, gradient, machine. Each replaces docs/standard-library/<module>.md where one exists.

Acceptance criteria

  • Every page has the kind page and is written as book/CONCEPT.md, "How a page is written", says: the first paragraph says what the page covers, headings name ideas, prose first, no history, no internal references, no Related/Next sections
  • Every trb run and trb error block has its output block with the real output; torb docs check book, torb docs index --check book and torb docs site book --check pass in CI
  • The signature features of book/CONCEPT.md that the area touches are shown, not just named
  • The old pages of docs/ this slice replaces are deleted in the same PR, unless a skill is still built from them (then they stay, unpublished, and the PR says which)
  • Each page opens with what the module is for and an example of the most common task, then covers the handful of tasks people use it for, each with an example and its output; it does not list every declaration
  • Each page names its module in the front matter (package: std/<module>), so the site links the generated API reference of torb doc std
  • Concurrent examples print in an order that is the same on every run

Children

  • #671 (task, parallel)
  • #672 (ecs)
  • #673 (geometry, linear)
  • #674 (gradient, machine)
Slice of the epic #582. Starts after #585 (the concept, the vertical slice and the book gates) is merged. ## Scope Write one hand-written page in `book/std/` per module: `task`, `parallel`, `ecs`, `geometry`, `linear`, `gradient`, `machine`. Each replaces `docs/standard-library/<module>.md` where one exists. ## Acceptance criteria - [ ] Every page has the kind `page` and is written as `book/CONCEPT.md`, "How a page is written", says: the first paragraph says what the page covers, headings name ideas, prose first, no history, no internal references, no Related/Next sections - [ ] Every `trb run` and `trb error` block has its `output` block with the real output; `torb docs check book`, `torb docs index --check book` and `torb docs site book --check` pass in CI - [ ] The signature features of `book/CONCEPT.md` that the area touches are shown, not just named - [ ] The old pages of `docs/` this slice replaces are deleted in the same PR, unless a skill is still built from them (then they stay, unpublished, and the PR says which) - [ ] Each page opens with what the module is for and an example of the most common task, then covers the handful of tasks people use it for, each with an example and its output; it does not list every declaration - [ ] Each page names its module in the front matter (`package: std/<module>`), so the site links the generated API reference of `torb doc std` - [ ] Concurrent examples print in an order that is the same on every run ## Children - [ ] #671 (task, parallel) - [ ] #672 (ecs) - [ ] #673 (geometry, linear) - [ ] #674 (gradient, machine)
orion commented 2026-10-30 03:34:00 +00:00
Author
Collaborator
Copy link

[loop:torbscript] intake: in scope (book std pages, slice of epic #582; dependency #585 is merged), no duplicate, no seed impact. Next: refine (seven modules; size check and split just in time, after the open book PRs have cleared CI).

[loop:torbscript] intake: in scope (book std pages, slice of epic #582; dependency #585 is merged), no duplicate, no seed impact. Next: refine (seven modules; size check and split just in time, after the open book PRs have cleared CI).
orion commented 2026-10-30 03:54:27 +00:00
Author
Collaborator
Copy link

[loop:torbscript] refine: too large for one PR (seven modules); split into #671 (task, parallel), #672 (ecs), #673 (geometry, linear), #674 (gradient, machine), all unready. Release; wait until 2026-10-30T09:00Z: the children become ready one at a time once the open book PRs #655, #663, #670 have cleared CI and merged.

[loop:torbscript] refine: too large for one PR (seven modules); split into #671 (task, parallel), #672 (ecs), #673 (geometry, linear), #674 (gradient, machine), all unready. Release; wait until 2026-10-30T09:00Z: the children become ready one at a time once the open book PRs #655, #663, #670 have cleared CI and merged.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
loop/705-default-shadow
loop/691-tensor-core
loop/705-fix-candidate
orion/456-tierb-probe
loop/164-measure2
loop/207-measure
loop/164-prototype
probe/207-count
loop/205-measure
loop/140-hide-staged
nightly-20261103
nightly-20261031
nightly-20261029
nightly-20261027
nightly-20261026
nightly-20261025
nightly-20261024
nightly-20261023
nightly-20261021
nightly-20261020
nightly-20261015
nightly-20261014
nightly-20261013
nightly-20261011
nightly-20261010
nightly-20261009
nightly-20261008
seeds
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
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#599 book: retire the human pages of docs/
torbscript/language
Depends on
#585 docs(book): a book for people, and the site built from it
torbscript/language
Reference
torbscript/language#595
No description provided.