Repository navigation
A Contributed Packages section for nine TWINSERV packages, and a draft command and workflow for the package indexer - #228
Merged
Conversation
…e sample did not; a different mode is refused with error 5 once a keyed item is in, not rehashed
…checked against their TWINSERV sources, with their snapshots; left out of the book
… for each package
… section, the package fetched from TWINSERV at its indexed version and embedded; an error inside an embedded package is a note, not a template FAIL
…ld; BigNumberLib and WinReg do not compile on BETA 1005, and WinReg's readers need WinDevLib too
…le per package, and the marked-sample count
…nstalled (owner's rule)
… compile on BETA 1005: their pages are kept, excluded in _config.yml, and left out of the landing list and the book
…ir TWINSERV sources, their 72 samples compiled and 55 run, with their snapshots, sample templates and book chapters
…h Fmt and OLEGuids
…own layout; indexer/draft/workflow.mjs, the doc-draft workflow moved out of .claude/, writes them from its manifest
…ince Index.html is the folder's index.html on Windows
…GitHub link where a repository holds the package or the library it is made from; no TOC on a landing page of one or two sections
…blisher, which the workflow writes as its Author line
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a Contributed Packages section for the community packages published through TWINSERV, the templates that compile its samples, and
twin-index draftwith a Claude Code workflow that places and writes the pages a new build or package leaves.Reference/Contributed/(new; 935 to 1066 pages) documents eleven packages against their TWINSERV sources, each at the version itsindexed_fromnames; AutoCompleteLib, BigNumberLib and VBComDlg cover their main class only. Each landing page opens with its author, and three link the GitHub repository of the package or of the library it is made from. Packages links to the section, and the book's Packages part gains a chapter for it and one for each published package._config.yml. Each landing page says so in a NOTE, and the comment in_config.ymlsays how to bring one back.vbTextCompare, as the text said and the sample did not. A different mode is refused with error 5 once a keyed item has been added; the page said the keys were rehashed.contributed-<Package>template intest/example-projects/that references its package, as a reader's project does.check_examplesdownloads the package from TWINSERV at the version the reference names, caches it in%TEMP%\tb-twinserv\and embeds it in every project staged from the template, so no package code is committed. An error inside an embedded package is reported as a note naming it, not as a template FAIL. The section's 162 samples compile and are markedcheck_build, and Fmt's 55check_runsamples also run.indexer/lib/draft-plan.mjs):twin-index draftplaces each pageanalyzelists, with its file, parent and permalink, from the section's own layout, because the sections do not share one. Leaving each symbol out of the documented sections and planning it again places 994 of 998 members and 138 of 156 types on the page the section has them on. Its plans and batches of up to twelve pages go toindexer/.packages/draft/. A package with no section gets a landing page like its group's, with the publisher TWINSERV lists as its author.indexer/draft/workflow.mjs): takes the manifest and writes the pages with Sonnet agents, one per batch, then for each package one for the landing page and member lists and one that compiles the section's samples and fixes what the compiler refuses. It commits nothing and runs only when the owner asks.WIP.mdandWIP.Indexer.mddescribe it, not the published docs; Build and Generation Tools documentsdraft.api.jsonsnapshots underindexer/snapshots/contributed/, one for the version each section documents.WIP.md,WIP.ExamplesBuild.mdand Code Samples and Attributes record where the section lives, what a landing page opens with, the rule that a contributed package is documented against the newest BETA installed, and the template conventions.test/indexer.test.mjsgains 12 tests (94 to 106) for the planner,check_clipinsdraft's refusals, andrunProbescoversembeddedPackages,splitPackageFaultsand thecontributed-WinRegtemplate chain. The workflow script is outside Biome, as Wisdom's is.examples.batneeds a twinBASIC install and, the first time a package version is needed, the network, anddraftneeds the storesyncwrites, so both stay outside every gate and CI. The tests, probes and command-line cases need neither and run intest.bat.