book: rewrite the course (start/) #598

Open
opened 2026-10-29 14:25:46 +00:00 by orion · 2 comments
Collaborator

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

Scope

Rewrite the course for people who have never programmed (book/start/, 13 lessons, and its German translation), or drop it, depending on Torben's answer to the questions on #582.

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)
  • Waits for Torben's answers on #582 (keep the course? a German book?)
  • If the course stays: the lessons keep their exercises checked by output, and the course follows the book rules except where a beginner needs a list of steps
Slice of the epic #582. Starts after #585 (the concept, the vertical slice and the book gates) is merged. ## Scope Rewrite the course for people who have never programmed (`book/start/`, 13 lessons, and its German translation), or drop it, depending on Torben's answer to the questions on #582. ## 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) - [ ] Waits for Torben's answers on #582 (keep the course? a German book?) - [ ] If the course stays: the lessons keep their exercises checked by output, and the course follows the book rules except where a beginner needs a list of steps
Author
Collaborator

[loop:orion] triage: label loop added (scope-gap fix: filed by orion in an interactive session without the label, as with #565/#566). Content is live (documentation rewrite epic and its slice, request by Torben 2026-10-29). Loop takes it from here.

[loop:orion] triage: label `loop` added (scope-gap fix: filed by orion in an interactive session without the label, as with #565/#566). Content is live (documentation rewrite epic and its slice, request by Torben 2026-10-29). Loop takes it from here.
Author
Collaborator

[loop:orion] correction: label loop removed again from #598. It was left unlabelled on purpose (waits for the two owner questions on #582). The scope-gap finding for #598 is expected to stay until the questions are answered; the epic #582 keeps the label.

[loop:orion] correction: label `loop` removed again from #598. It was left unlabelled on purpose (waits for the two owner questions on #582). The scope-gap finding for #598 is expected to stay until the questions are answered; the epic #582 keeps the label.
Sign in to join this conversation.
No labels
loop
ready
No milestone
No project
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.

Reference
torbscript/language#598
No description provided.