book: Reference, part 2 (errors, traits, generics, collections, modules, concurrency, encoding) #590
Labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Blocks
Depends on
#599 book: retire the human pages of docs/
torbscript/language
#585 docs(book): a book for people, and the site built from it
torbscript/language
Reference
torbscript/language#590
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Slice of the epic #582. Starts after #585 (the concept, the vertical slice and the book gates) is merged.
Scope
Write these pages of
book/reference/, each complete for its area:docs/reference/errors.mdlanguage/errors/*reference/traits.mdlanguage/traits/*reference/generics.mdlanguage/generics/*reference/collections.mdlanguage/collections-and-iteration/*reference/modules-and-packages.mdlanguage/modules-and-packages/*reference/concurrency.mdlanguage/concurrency-and-streams/*reference/encoding-and-decoding.mdlanguage/reflection/*,language/extensibility/expression-trees.mdAcceptance criteria
pageand is written asbook/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 sectionstrb runandtrb errorblock has itsoutputblock with the real output;torb docs check book,torb docs index --check bookandtorb docs site book --checkpass in CIbook/CONCEPT.mdthat the area touches are shown, not just nameddocs/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)trb run/trb errorexamplesPages
Filed as child issues, each its own PR, all carrying
loop; none isreadyyet, they are made ready one after the other. The pages are independent (links only to pages already on main), so the order is a suggestion. The first slice that touches a page set also decides theorder:front matter of the Reference index.reference/errors.md- #620reference/propagating-errors.md- #621reference/panics.md- #622reference/traits.md- #623reference/extending-and-delegating.md- #624reference/operators.md- #625reference/generics.md- #626reference/collections.md- #627reference/iteration.md- #628reference/modules.md- #629reference/packages.md- #630reference/tasks.md- #631reference/channels-and-streams.md- #632reference/encoding-and-decoding.md- #633Changes against the table above:
errorsis cut intoerrors,propagating-errorsandpanics;traitsintotraits,extending-and-delegatingandoperators;collections-and-iterationintocollectionsanditeration;modules-and-packagesintomodulesandpackages;concurrencyintotasksandchannels-and-streams.genericsandencoding-and-decodingstay one page each. The old pages of these areas are claimed by no child of #587, #588 or #589.[loop:torbscript] intake: in scope (book Reference part 2, slice of epic #582), no duplicate. Next: refine (split like #589).
[loop:torbscript] claim refine by session:loop-torbscript-20261029-0858 until 2026-10-30T00:22Z
[loop:torbscript] release refine: filed #620 (errors), #621 (propagating-errors), #622 (panics), #623 (traits), #624 (extending-and-delegating), #625 (operators), #626 (generics), #627 (collections), #628 (iteration), #629 (modules), #630 (packages), #631 (tasks), #632 (channels-and-streams), #633 (encoding-and-decoding). The old material of the seven areas is about 220 KB, too much for one PR, so each child is one page or a small group of 2-7 old pages, 30-40 minutes, with the criteria of this issue and its own
Replaces in docs/list; #590 now carries the checklist and noready. All children carryloopand none isready(they are made ready one after the other; the pages do not depend on each other, links only to pages already on main). No conflict with #587/#588/#589: none of them claims a page under docs/language/{errors,traits,generics,collections-and-iteration,modules-and-packages,concurrency-and-streams,reflection} or extensibility/expression-trees.md.[loop:torbscript] next: waiting (children #620, #621, #622, #623, #624, #625, #626, #627, #628, #629, #630, #631, #632, #633)