docs(book): std iteration and function types #676
argus
Loading…
Reference in a new issue
No description provided.
Delete branch "loop/642-std-iteration"
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?
Task
Issue #642: the book pages for
std/iterationandstd/function-types.book/std/iteration.md(order: 80): filter, map and collect; laziness; stopping early; terminal operations; reshaping stages; collectors (counting,summing,averaging,minBy,maxBy,joining,partitioningBy,groupingBy ... then); writing a collector (collector,mergingCollector); making a type iterable; reusableStages;concatenated.book/std/function-types.md(order: 90):Predicate,Action,Transformas transparent aliases, how type arguments are worked out through the alias, and the shapes that keep their own spelling.book/std/index.md: regenerated withtorb docs index book, two new entries.Every
trb run/trb errorblock is followed by its real output block, produced with the nightlytorb(13 blocks in iteration, 6 in function-types; a re-run compares equal).Old pages
docs/standard-library/iteration.mdanddocs/standard-library/function-types.mdstay in place and unpublished: the skilltorbscript-standard-libraryis generated fromdocs/standard-library/. No other page changes.Checks (nightly torb 20261029)
torb docs index book --check: 8 indexes, up to datetorb docs site book --check --no-native: 49 pages, no broken linktorb docs skill docs skills --check: 7 skills, up to datedocs checkbook rules are outdated (it rejects existing pages), so the book rules were checked by hand: command-call style, no history words, no issue numbers or links into docs/design, docs/contributing or docs/internals, no Related/Next sections, every section starts with a sentence. CI runs the realdocs checkandgates.sh.Notes
groupingBy { _.key }.then(...)fails with "The checker did not work out the type of this expression"; the page uses a typed key closure ({ order: Order => order.customer }) and says why.Stagealso works onstd/streamSources comes from the std doc comment and was not run here.book/std/index.md; re-runtorb docs index bookafter they merge.Closes #642
Not mergeable on
9f283fc: rebase onto main (d307c11; likely the generated block ofbook/std/index.md, re-runtorb docs index book); no other blockers.9f283fc802c8b8c4f61aNot mergeable on
c8b8c4f: rebase onto main (c4cac72; likely the generated block ofbook/std/index.md, re-runtorb docs index book); no other blockers.c8b8c4f61ac74a4c44f0Not mergeable on
c74a4c4: rebase onto main (463767c; likely the generated block ofbook/std/index.md, re-runtorb docs index book); no other blockers.c74a4c44f018e40dbb97Checklist on
18e40db:trb run/trb errorblock is followed by anoutputblock.groupByorder, collector results,Stagecomposition); the one unverified claim (Stage onstd/stream) is disclosed in the PR body.book/std/index.mdblock; olddocs/standard-library/pages stay unpublished with the reason named (skill is generated from them). No other page changed.package:set, no issue numbers or links into docs/design/contributing/internals, no Related/Next sections, lists under seven items.Non-blocking:
function-types.md/iteration.md: the sentence "A stage ... answers anIterateagain" reads oddly; consider "yields a newIterate".iteration.md"Stages you write once": thestd/streamsentence is stated as fact but was not run; consider softening or adding a run block once someone can verify it.torb docs index bookre-run (already noted by the author).