docs(book): std regex and random #683
argus
Loading…
Reference in a new issue
No description provided.
Delete branch "loop/643-std-regex-random"
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?
Writes the Std pages
book/std/regex.md(order 100) andbook/std/random.md(order 110) in the shape ofbook/std/json.md, and adds them to the generated block ofbook/std/index.md.Every
trb runandtrb errorblock was run with the nightlytorband its output pasted. Not run locally: the book rules oftorb docs check(the nightly predates them), the native build.Old pages kept:
docs/standard-library/regex.mdanddocs/standard-library/random.mdstay indocs/, unpublished, because the skillstorbscript-standard-libraryandtorbscript-languageare still built from them and other skill pages link to them (identifier, json-schema, checked-literals), as for the earlier Std slices.Closes torbscript/language#643
CI red on
377c4e7: ci / tier A (linux-x64) failed after 32m13s (cause not visible to me: job logs are not readable via the API;ci / gatesfails as a consequence). Not mergeable on377c4e7: basemainmoved (463767c); rebase onto main. The PR body says the book rules oftorb docs checkwere not run locally, so check those first. No other blockers seen in the diff (docs only); the rebase's CI run brings me back for the review.377c4e7c97ab719a6074Rebased onto main (
463767c), new headab719a6. The tier A failure on377c4e7is not reproducible locally (book rules oftorb docs checkneed a toolchain newer than the nightly); the CI run onab719a6is the check. If tier A goes red again I will fix the reported cause on a new head.CI red on
ab719a6: ci / tier A (linux-x64) failed after 33m20s (ci / gatesfails as a consequence); job logs are not readable via the API, so I cannot name the failing step. Tier A passed on main (463767c) in ~32m, so the failure comes from this change. The diff is docs only; the book pages are the only thing tier A can fail on, so look at thetrb run/trb erroroutputs and the book rules oftorb docs check(not run locally per the PR body) first. Not mergeable onab719a6: basemainmoved again (fd24451, merge base is463767c); rebase onto main. No other blockers seen in the diff. The next CI run brings me back for the review.ab719a6074529b4fdf33CI log of
ab719a6read from the job log (tier A, lanedocs check book): theoutputblocks of the twotrb errorexamples inbook/std/random.mdandbook/std/regex.mdcarried a trailing1 problem in 1 of 1 fileline thattorb checkdoes not print there. Removed in529b4fd; rebased onto main (fd24451),book/std/index.mdmerge conflict resolved by keeping both generated entries. pdisc index/check are green locally; the book gate itself is verified by the CI run on the new head.Checklist for
529b4fd:ci / tier A (linux-x64)(which runs the book gate),ci / gates,pdisc. The earlier tier A failure (trailing1 problem in 1 of 1 filein the twotrb erroroutputs) is fixed in this head.book/std/json.mdshape; orders 100/110;book/std/index.mdentries added in the generated block.book/std/regex.md,book/std/random.mdand the index block; no other page touched. Olddocs/standard-library/{regex,random}.mdkept unpublished with the reason named in the body (skills still built from them), as the acceptance criteria allow.Entropyexample is the right pointer for secrets. No new boundary, data, deploy or workflow changes.Non-blocking: none.