docs(book): guide chapter modelling data #645
argus
Loading…
Reference in a new issue
No description provided.
Delete branch "loop/636-guide-modelling-data"
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?
Closes #636
Summary
Adds the Guide chapter
book/guide/modelling-data.md(kindpage,status: stable, order 15, so it sits second after "A first project"). One club member list grows through the chapter: data with fields and defaults and anOptionfield (no null), aPlancase type with amatchthat does not compile when a case is missing (every case is handled), a capsule (Email, checked once withTryFrom<String, String>,Resultand?, no exceptions) and when to choose it over data, a builder (club { ... }with a receiver closure), a type as a map key (what it needs to beHash, tuple keys,getvs[]), and conversions (From/Into,TryFromfor parsing text, what fails, collecting withto()).book/guide/index.mdhas the new entry (generated bytorb docs index book).How verified
trb runblock was run withtorbnightly-20261029 and everytrb errorblock checked withtorb check main.trb; the pastedoutputblocks equal the real output (compared mechanically, error output fromerror:on, without the "1 problem" line, like the existing chapters). Blocks are intorb formatlayout.torb docs index --check book: up to date.torb docs skill docs skills --check: 7 skills, all up to date.torb docs check bookandtorb docs site book --checkcannot be judged locally: the nightly does not yet understand the book mode (it reports the same kind of rule violations for the already merged chapters), and the machine has no C compiler. They run in CI viatools/gates.sh.Old pages: kept, not deleted
All four stay in
docs/, unpublished, because the skills are still built from them:docs/how-to/write-a-builder.md,docs/how-to/use-a-type-as-a-map-key.md,docs/how-to/convert-between-types.md: carried bydocs/skills/torbscript-language/SKILL.md(<!-- carry: how-to/... -->), the same wayhow-to/define-an-error-type.mdstays after the "Handling errors" chapter.docs/language/types/data-or-capsule.md: a page oflanguage/, which the same skill carries as a whole (reference rules 1-7); about 15 other pages of the skills anddocs/designlink to it.No link had to change, no other book page is touched, and
skills/needs no regeneration (checked above).Approved at
c5c83a6.?chain, map key counts,TryFromresults); PR body states each block was run with the nightly and compared mechanically.docs/skills/torbscript-language/SKILL.mdcarrieslanguage/and the three how-tos (carry:lines 8-11), so deleting would breakdocs skill --check.book/guide/index.mdentry present, pdisc green. No secrets, no external requests.Non-blocking: none.