docs(book): std text and identifier #663
argus
Loading…
Reference in a new issue
No description provided.
Delete branch "loop/640-std-text"
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 #640
Adds the Std pages
book/std/text.md(package: std/text) andbook/std/identifier.md(package: std/identifier), written likebook/std/json.md, and regenerates the generated block ofbook/std/index.md.What the pages cover
length()error), cutting withOptionanswers (splitOnce,withoutPrefix,substringBefore,prefix/dropping),TextIndexpositions (with thetext[3..]error), Unicode case conversion, and working withChar.Uuid.version4/version7,Ulid.generatedwithafter, seeding fromEntropyandClock, reading back withIdentifierError, use as sort key,Mapkey and JSON field, theurn:uuid:bridge, and copies of a generator.Old pages
docs/standard-library/text.mdanddocs/standard-library/identifier.mdstay indocs/, unpublished (the site is built frombook/only), likejson.mdandfs.mdafter the first Std slice: the Agent Skilltorbscript-standard-libraryis generated from them (skills/torbscript-standard-library/references/standard-library/text.mdandidentifier.md, and its index lines) and needs the complete declarations, which the short book pages deliberately leave to the generated reference. Deleting them would remove two references from the skill. Nothing indocs/orskills/changed, sotorb docs skill docs skills --checkis unaffected.Test
Every
trb runandtrb errorblock was run with atorbnightly build and its output compared with theoutputblock (all match; fortrb errorfromerror:on).torb docs index bookwrote the index block. The repository gates (torb docs check book,torb docs index --check book,torb docs site book --check,tools/gates.sh) were not run locally; they run in CI.Not mergeable on
bae3822: rebase onto main (main moved with changes tobook/std/index.md, so the generated index block needs regenerating viatorb docs index book); no other blockers.bae3822e1fe8bd0d4770Review of
e8bd0d4(docs-only: two Std book pages + generated index block).trb run/trb errorblock was run with a nightlytorband matches; the book gates run in CI.book/std/json.md(kind page, status stable, order, package). Each run/error block is followed by anoutputblock. No placeholder text.book/std/text.md,book/std/identifier.md, and the generated block ofbook/std/index.md. No other book page, no code.docs/standard-library/text.mdandidentifier.mdunpublished is justified in the PR body (the Agent Skill is generated from them), as the acceptance criteria allow.Non-blocking: none.