book: Std pages, data formats #592
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#592
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 one hand-written page in
book/std/per module:encoding,json-schema,toml,yaml,xml,html,markdown,binary,archive,compression,uri. Each replacesdocs/standard-library/<module>.md.Acceptance 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)package: std/<module>), so the site links the generated API reference oftorb doc stdPages
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.std/xml.md(#649) waits for the PR of #605, which editsdocs/standard-library/xml.md.std/encoding.md- #646 (PR #670 in review)std/json-schema.md- #647std/toml.md,std/yaml.md- #648std/xml.md- #649std/html.md- #650std/markdown.md,std/compression.md- #651std/binary.md,std/archive.md- #652std/uri.md- #653The old material of the eleven modules is about 143 KB, too much for one PR, so each child is one page or a small group of 2 pages. No other Std slice (#591, #593 to #595) claims these modules.
[loop:torbscript] intake: in scope (book std pages, slice of epic #582; dependency #585 is merged), no duplicate, no design-record collision, no seed impact. Next: refine (size check: 11 module pages in one PR is too large, split into one-page or small-group children).
[loop:torbscript] claim refine by session:loop-torbscript-20261030 until 2026-10-30T06:10Z
[loop:torbscript] release refine: the old material of the eleven modules is about 143 KB, too much for one PR; filed #646 (encoding), #647 (json-schema), #648 (toml, yaml), #649 (xml), #650 (html), #651 (markdown, compression), #652 (binary, archive), #653 (uri), each one page or two, 30-40 minutes, with the criteria of this issue and its own
Replaces in docs/list. #592 now carries the checklist and noready. All children carryloopand none isready; #649 waits for the PR of #605 (it edits docs/standard-library/xml.md).[loop:torbscript] next: waiting (children #646, #647, #648, #649, #650, #651, #652, #653)
[loop:torbscript] wait until 2026-10-30T09:00Z: children #646 to #653 are filed and not ready; four PRs (#655, #663, #635, #601) are open with CI still pending in the congested forge queue. Next: make #646 ready once one of them has merged or its CI has finished (#649 only after #637, which is merged, so it is free too).
[loop:torbscript] wait until 2026-10-30T09:00Z: #646 (encoding) is ready and claimed by a worker; #647 to #653 stay unready while PRs #601, #655, #663 and the new #646 PR clear the forge CI. Next: make the next child ready once one of them has merged.