rajames/LithosAnanke
1
1
Fork 0
Code Issues 60 Pull Requests Actions Packages Projects Releases Activity

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

New Issue
Open
opened 2026-11-07 20:15:22 +00:00 by rajames · 0 comments
rajames commented 2026-11-07 20:15:22 +00:00
Owner
Copy Link
Copy Source

Ruled

Captain Bob, 2026-11-07: "build a 'The Book of Fabric' and publish it as version every release".

Built (to do)

  • One PDF, The Book of Fabric, <version> and the commit on its title page: docs/fabric/FABRIC-0 through FABRIC-4 (~30,000 lines) as parts, in order, with a contents; the closed ones marked as history, FABRIC-3 as the living record
  • Through the existing book pipeline (docs/book/, pandoc -> LaTeX -> PDF); make fabric; a stage in scripts/nightly.sh docs
  • Published as org.starship:documentation:<version>, classifier fabric, with every release (and the nightlies); a download once #126 is in

Done when

  • The PDF builds from the tree; published by a release; checked that every FABRIC section is in it

🤖 Filed with Claude Code -- the review after v4.0.0-alpha.3 (Captain Bob, 2026-11-07: "a list of problems, deficiencies, smells and so on placed in issues by rank priority").

### Ruled Captain Bob, 2026-11-07: "build a 'The Book of Fabric' and publish it as version <version> every release". ### Built (to do) - One PDF, *The Book of Fabric*, `<version>` and the commit on its title page: `docs/fabric/FABRIC-0` through `FABRIC-4` (~30,000 lines) as parts, in order, with a contents; the closed ones marked as history, FABRIC-3 as the living record - Through the existing book pipeline (`docs/book/`, pandoc -> LaTeX -> PDF); `make fabric`; a stage in `scripts/nightly.sh docs` - Published as `org.starship:documentation:<version>`, classifier `fabric`, with every release (and the nightlies); a download once #126 is in ### Done when - [ ] The PDF builds from the tree; published by a release; checked that every FABRIC section is in it 🤖 Filed with [Claude Code](https://claude.com/claude-code) -- the review after v4.0.0-alpha.3 (Captain Bob, 2026-11-07: "a list of problems, deficiencies, smells and so on placed in issues by rank priority").
rajames added this to the v4.0.0-alpha.4 milestone 2026-11-07 20:15:22 +00:00
rajames added the
kind
feature
kind
docs
priority
should
status
backlog
 labels 2026-11-07 20:15:23 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/capsules
capsules/ and mkcapsule
 area/docs
docs/
 area/kernel
kernel/ -- LithosAnanke
 area/proofs
proof/ -- Isabelle/HOL
 area/v3
v3/ -- the original StarForth VM
 area/v4
v4/ and capsules/v4 -- the F18 engine
 board/milkv
Milk-V Mars
 board/pc
Generic x86-64 PC (SER5)
 board/raspi4
Raspberry Pi 4 (not ported)
 board/raspi5
Raspberry Pi 5
 board/zynq7020
Zynq-7020 (ARMv7 port in progress)
kind
bug
Something is wrong
kind
chore
Housekeeping, repo hygiene
kind
ci
Build, CI, nightly, release
kind
docs
Documentation only
kind
feature
New capability
priority
must
Needed for v4.0.0 (JUSTIFICATION.md 14/16)
priority
nice
Nice to have
priority
should
Needed for the product, not for the tag
status
backlog
Not started
status
blocked
Waiting on something else
status
in-progress
Being worked on
status
needs-acceptance
Done; the QEMU acceptance boots are still to run
status
rejected
Decided against; closed
No labels
kind
docs
kind
feature
priority
should
status
backlog
Milestone
No items
No Milestone v4.0.0-alpha.4
Projects
Clear projects
No projects
Assignees
Clear assignees
rajames (Robert A. James (Captain Bob))
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rajames/LithosAnanke#138