docs: The Book of Fabric -- the FABRIC design record as one book, built and published with every release (#138) [skip ci]
`make fabric` -> build/docs/BookOfFabric.pdf (722 pages): Part I the living record (FABRIC-3), Part II the closed documents in the order written, Part III the forward-looking notes; its title page carries the version (git describe --tags: a release's tag) and the commit. Built from the same pandoc fragments as the book; the book's preamble moved into docs/book/preamble.tex, shared by both (the book builds as before, 821 pages). scripts/nightly.sh: the docs stage builds it ($DOCS/fabric.pdf); publish sends it as classifier `fabric`; gitea-release attaches every PDF in $DOCS, so every release carries it. Progress for the rest of alpha.4's documents: docs/v4.0.0/plans/2026-11-10-alpha4-documents.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
This commit is contained in:
@@ -0,0 +1,26 @@
|
||||
# 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
|
||||
- [ ] the live word list of the built system (318 words)
|
||||
- [ ] the table in the tree: name, stack effect, description, where defined
|
||||
- [ ] the check: every live word has an entry, every entry is a live word
|
||||
- [ ] 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
|
||||
Reference in New Issue
Block a user