The dictionary of v4 (alphabetical, stack notation, description) and a Documents page on the .com #157

New Issue

2026-11-08T13:15:24Z

rajames commented

2026-11-08 13:15:24 +00:00

Ruled

Captain Bob, 2026-11-08: "some of our document built pdf's should be published on .com; The Book of Fabric and a 'dictionary' document with the word, stack notations and descriptions. Alphabetical." -- v4's words only (v3 is being retired, #156); a Documents page on the .com; with alpha.4, beside Downloads (#126).

Built (to do)

The dictionary of v4, one PDF, <version> and the commit on its title page: every word v4 boots with (PARITY:V4_SYSTEM word_count, 317 today -- capsules/v4/sys/*.f18, capsules/v4/*.4th, the kernel's host words), alphabetical, each with its stack notation and a description, and where it is defined.
Its source in the tree: a table (name, stack effect, description) joined at build to the live word list of the built system, so the names are never typed by hand.
A check that fails the build when a live word has no entry, or an entry names no live word: the dictionary cannot fall behind the system.
Built by the docs pipeline (make dictionary; scripts/nightly.sh docs), attached to every release beside the Book of Fabric (#138), published as org.starship:documentation:<version>, classifier dictionary.
The .com's Documents page (a canvas artboard first, then site/com): the Book of Fabric and the Dictionary -- and the book, the three volumes and the API reference the release already attaches -- each linking its PDF on the release, with its version and SHA-256; built from the release, as the Downloads page is (#126). In the .com's navigation beside Downloads.

Done when

The dictionary PDF builds, alphabetical, every live v4 word in it with a stack notation and a description; the check refuses a missing word
Both PDFs attached by the alpha.4 release
The Documents page on the .com links them, with checksums

### Ruled Captain Bob, 2026-11-08: "some of our document built pdf's should be published on .com; The Book of Fabric and a 'dictionary' document with the word, stack notations and descriptions. Alphabetical." -- **v4's words only** (v3 is being retired, #156); **a Documents page on the .com**; **with alpha.4**, beside Downloads (#126). ### Built (to do) - **The dictionary of v4**, one PDF, `<version>` and the commit on its title page: every word v4 boots with (`PARITY:V4_SYSTEM word_count`, 317 today -- `capsules/v4/sys/*.f18`, `capsules/v4/*.4th`, the kernel's host words), **alphabetical**, each with its **stack notation** and a **description**, and where it is defined. - Its source in the tree: a table (name, stack effect, description) joined at build to the **live word list** of the built system, so the names are never typed by hand. - **A check that fails the build** when a live word has no entry, or an entry names no live word: the dictionary cannot fall behind the system. - Built by the docs pipeline (`make dictionary`; `scripts/nightly.sh docs`), attached to every release beside the Book of Fabric (#138), published as `org.starship:documentation:<version>`, classifier `dictionary`. - **The .com's Documents page** (a canvas artboard first, then `site/com`): the Book of Fabric and the Dictionary -- and the book, the three volumes and the API reference the release already attaches -- each linking its PDF on the release, with its version and SHA-256; built from the release, as the Downloads page is (#126). In the .com's navigation beside Downloads. ### Done when - [ ] The dictionary PDF builds, alphabetical, every live v4 word in it with a stack notation and a description; the check refuses a missing word - [ ] Both PDFs attached by the alpha.4 release - [ ] The Documents page on the .com links them, with checksums

rajames added this to the v4.0.0-alpha.4 milestone 2026-11-08 13:15:24 +00:00

rajames referenced this issue from a commit

2026-11-08 13:15:38 +00:00

FABRIC-3 XLVIII.11: the Book of Fabric and the dictionary on the .com, ruled for alpha.4 (#138, #157) [skip ci]

rajames referenced this issue

2026-11-08 13:29:03 +00:00

DoE per release: run, analyse (R, LaTeX), publish to the .com XWiki #158

rajames referenced this issue

2026-11-08 13:39:51 +00:00

The Book of Fabric: the FABRIC record as one book, published with every release #138

Sign in to join this conversation.