Files
LithosAnanke/docs/v4.0.0/plans/2026-11-10-alpha4-documents.md
T
Claude a53cc82dd5 docs(dictionary): mkdictionary.py and the draft table -- every live v4 word, 318 (#157) [skip ci]
The names from the system itself (the hosted v4's WORDS, plus the kernel's sk_v4_words[]); the stack notation and description in docs/reference/v4-dictionary.tsv, drafted from the source where it says (54 stacks, 105 descriptions), the rest to write. check refuses a missing, unfinished or stale entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
2026-11-10 11:25:01 +00:00

27 lines
1.9 KiB
Markdown

# alpha.4's documents and pages -- progress (kept current, one line per increment)
Captain Bob, 2026-11-10: "Do it" -- the rest of alpha.4 that lives in the tree, after #92 (merged,
#160). #133 and #134 are the server's (Captain Bob's).
## #138 -- The Book of Fabric
- [x] `docs/book/fabric.tex`: the FABRIC record as one book -- Part I the living record (FABRIC-3),
Part II the closed ones in order, Part III the forward-looking notes; title page with the
version (`git describe --tags`) and the commit. The book's preamble moved into
`docs/book/preamble.tex`, shared by both books (the book itself builds unchanged, 821 pages).
- [x] `make fabric` -> `build/docs/BookOfFabric.pdf` (722 pages, 42 s).
- [x] `scripts/nightly.sh docs` builds it (`$DOCS/fabric.pdf`); `publish` sends it as
`org.starship:documentation:<version>`, classifier `fabric`; `gitea-release` attaches every
PDF in `$DOCS`, so the release carries it.
## #157 -- the dictionary of v4, and the .com's Documents page
- [x] the live word list of the built system (318 words): `v4/tools/mkdictionary.py words` -- the hosted v4's `WORDS` (317) plus the kernel's `sk_v4_words[]` (`MINT-ZUSE`)
- [~] the table in the tree, `docs/reference/v4-dictionary.tsv`: drafted for all 318 (`mkdictionary.py draft`; the source gave a stack comment for 54, a description for 105); the rest written by hand in batches, alphabetical -- next: batch 1
- [x] the check: `mkdictionary.py check` -- every live word has a finished entry, every entry a live word (fails on all 318 drafts today, as it should); not yet in the build
- [ ] the PDF, alphabetical; `make dictionary`; the nightly's docs stage, classifier `dictionary`
- [ ] the Documents page: canvas artboard, then `site/com`
## #126 -- the Downloads page live
- [ ] `site/com` builds Downloads (and Documents) from the release: its tag, `SHA256SUMS`, the
Root CA's fingerprint
- [ ] the nav links on Home, Try it, Inquiries