book: site pages (install, playground, agents, benchmarks)

orion commented

2026-10-29 14:25:46 +00:00

Collaborator

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

Scope

Rework the pages of book/site/ that moved unchanged: install.md, play.md (taking over docs/tooling/the-playground.md), agents.md, benchmarks.md, and index.md.

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)
install.md says the one command per system first, then how to check the install, then what torb build needs
agents.md is for the person setting up an agent, not for the agent; the skill text itself stays in skills/
The numbers on benchmarks.md come from the benchmark run they cite, with its date and machine

Slice of the epic #582. Starts after #585 (the concept, the vertical slice and the book gates) is merged. ## Scope Rework the pages of `book/site/` that moved unchanged: `install.md`, `play.md` (taking over `docs/tooling/the-playground.md`), `agents.md`, `benchmarks.md`, and `index.md`. ## 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) - [ ] `install.md` says the one command per system first, then how to check the install, then what `torb build` needs - [ ] `agents.md` is for the person setting up an agent, not for the agent; the skill text itself stays in `skills/` - [ ] The numbers on `benchmarks.md` come from the benchmark run they cite, with its date and machine

orion added the

loop

label

2026-10-29 14:25:46 +00:00

orion added a new dependency

2026-10-29 14:25:51 +00:00

#585 docs(book): a book for people, and the site built from it

orion added a new dependency

2026-10-29 14:25:52 +00:00

#599 book: retire the human pages of docs/

orion referenced this issue

2026-10-29 14:25:57 +00:00

Epic: human documentation rewrite (by humans, for humans) #582

orion referenced this issue

2026-10-29 14:26:01 +00:00

Epic: human documentation rewrite (by humans, for humans) #582

orion referenced this issue

2026-10-29 20:39:21 +00:00

Epic: human documentation rewrite (by humans, for humans) #582

orion commented

2026-10-30 03:34:00 +00:00

Author

Collaborator

[loop:torbscript] intake: in scope (book site pages, slice of epic #582; dependency #585 is merged), no duplicate, no seed impact. Next: refine (five pages; size check, benchmark numbers need a dated run).

orion commented

2026-10-30 04:28:00 +00:00

Author

Collaborator

[loop:torbscript] wait until 2026-10-30T09:00Z: refine is due (five site pages; benchmarks.md needs a dated benchmark run for its numbers, to be settled in refine). The book slice queue is full behind PRs #601, #663, #670.

Rows
Columns

book: site pages (install, playground, agents, benchmarks) #597

Scope

Acceptance criteria