The code included in the Springer Owl book.
CI uses incremental verification: documentation changes do not build images;
ordinary changes run the affected examples, reusing matching full results for
unchanged chapters. Pull requests use short real checks for LDA/style training.
Environment changes invalidate the old full results. Manual Actions runs offer
auto, quick (never publishes) and full (reruns everything).
Daily checks skip the build when upstream versions and runtime inputs match
:latest. See the verification policy.
New self-contained examples go in code/chapXX_*/examples/name.ml. They are
compiled and run automatically by scripts/book_examples.py when new or changed.
Image validation checks their complete execution evidence. No edit to historical listing or plot
manifests is needed. The manuscript repository provides make example-new,
make example and make examples for creation and publication export; see its
contributor guide.
Optional sibling name.json selects installed findlib packages/runtime limits;
name.data/ supplies local inputs exposed as data/ during execution.
- Build, run and validate the Ubuntu book container
- All 398 original display blocks now have source mappings across Chapters 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, A and B.
Restoration includes the original datasets/model inputs where recovered, native runners and actual OCaml sessions. Chapter 12 performs all 1000 LDA iterations; Chapter 15 performs 250 NST and ten 100-update reconstruction runs, and verifies all six FST models. Some printed shapes, quotations, protocol and incomplete weight-exchange fragments are explicitly illustrative rather than executable.
The author approved second-edition replacements for the former 18 blocked regions:
Chapter 6 uses native RK45 and ODEPACK; Chapter 7 ships clearly labelled synthetic
CSV inputs with a fixed generator; Appendix A uses explicit precision conversion
in place of Owl.Ext. All 398 original IDs remain traceable (389 code/interface
blocks and 9 illustrative blocks); no blocked region remains in the current map.
The updated local image passes complete build-time and independent reader/PTY
validation. Illustrations are not counted as executed programs.
The exact latest-compiler/Owl environment includes recorded RK45 and blocked
convolution accuracy corrections plus CamlImages build compatibility changes.
All 18 publication snapshots, both code styles and the independent publisher
package pass. Consult the manuscript repository's STATUS.md for the immutable
image, exact source evidence and next review steps.
CI updates matrixanger/springer-book-code:latest after main-branch pushes and
daily builds pass the full book and registry-pull checks. Each publication pushes a
unique build-<code revision>-<run ID> tag and then deletes the older build tags. Failed checks
preserve the previous reader image. The former :pilot alias is retired.
To keep an edition's image, give it its own tag (for example edition-2); such tags are never deleted.
Local candidate tags are not Docker Hub release tags.