From d9741a03e8b4c84d10d8fe4a410ec08c460c01e4 Mon Sep 17 00:00:00 2001 From: Mathieu Barbin Date: Sun, 10 May 2026 13:08:35 +0200 Subject: [PATCH 1/6] Reference the test book in the doc --- doc/content/resources/_index.md | 6 ++++++ test/Makefile | 10 ++++++++++ test/book.toml | 8 ++++++-- 3 files changed, 22 insertions(+), 2 deletions(-) create mode 100644 test/Makefile diff --git a/doc/content/resources/_index.md b/doc/content/resources/_index.md index 5f11358..cadba63 100644 --- a/doc/content/resources/_index.md +++ b/doc/content/resources/_index.md @@ -13,3 +13,9 @@ what mdexp does and why it is useful. It walks through the core directives --- prose, code blocks, and snapshots --- with concrete examples in OCaml. **Authors:** Mathieu Barbin, Claude Opus 4.6 | **Audience:** New users + +## [Test Suite](../book/test-suite/) + +The internal test suite for mdexp, using mdexp of course. + +**Authors:** Mathieu Barbin, Claude Opus 4.7 | **Audience:** Mdexp developers and contributors diff --git a/test/Makefile b/test/Makefile new file mode 100644 index 0000000..70f5a96 --- /dev/null +++ b/test/Makefile @@ -0,0 +1,10 @@ +.PHONY: build serve clean + +build: + mdbook build + +serve: + mdbook serve --open + +clean: + mdbook clean diff --git a/test/book.toml b/test/book.toml index d37a505..858905e 100644 --- a/test/book.toml +++ b/test/book.toml @@ -1,11 +1,11 @@ [book] -title = "mdexp Test Suite" +title = "Mdexp Test Suite" authors = ["Mathieu Barbin"] language = "en" src = "." [build] -build-dir = "book" +build-dir = "../doc/static/book/test-suite" [output.html] git-repository-url = "https://github.com/mbarbin/mdexp" @@ -13,3 +13,7 @@ default-theme = "light" preferred-dark-theme = "navy" theme = "../doc/book/shared-theme" additional-js = ["../doc/book/shared-theme/ansi-plugin.js"] + +[output.html.fold] +enable = true +level = 0 From 9c4f7813bf39b7741f41b224a35126207b03f155 Mon Sep 17 00:00:00 2001 From: Mathieu Barbin Date: Sun, 10 May 2026 13:14:35 +0200 Subject: [PATCH 2/6] Doc make target rebuild included test book --- doc/Makefile | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/Makefile b/doc/Makefile index 67fd465..6a56dd2 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -4,6 +4,7 @@ build: build-books build-site build-books: mdbook build book/introduction-to-mdexp + cd ../test && mdbook build build-site: zola build From 038023bc2f3a87e49ac0ca98f252799896a1a03c Mon Sep 17 00:00:00 2001 From: Mathieu Barbin Date: Sun, 10 May 2026 13:43:43 +0200 Subject: [PATCH 3/6] Tweak title case --- test/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/README.md b/test/README.md index 4b64d8d..acd38e3 100644 --- a/test/README.md +++ b/test/README.md @@ -1,4 +1,4 @@ -# mdexp Test Suite +# Mdexp Test Suite This book contains the test suite for mdexp, organized as documentation. From 161b99be12803445e2bdbe04086d9686bf69381c Mon Sep 17 00:00:00 2001 From: Mathieu Barbin Date: Sun, 10 May 2026 13:52:41 +0200 Subject: [PATCH 4/6] Add local gitignore file --- doc/static/.gitignore | 1 + 1 file changed, 1 insertion(+) create mode 100644 doc/static/.gitignore diff --git a/doc/static/.gitignore b/doc/static/.gitignore new file mode 100644 index 0000000..3006b27 --- /dev/null +++ b/doc/static/.gitignore @@ -0,0 +1 @@ +book/ From 083215f95d11e211b3f2ac23c81b8b66fd36a58c Mon Sep 17 00:00:00 2001 From: Mathieu Barbin Date: Sun, 10 May 2026 14:20:33 +0200 Subject: [PATCH 5/6] Simplify title --- doc/config.toml | 2 +- doc/content/_index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/config.toml b/doc/config.toml index 8bb4a37..1e668fc 100644 --- a/doc/config.toml +++ b/doc/config.toml @@ -2,7 +2,7 @@ base_url = "https://mbarbin.github.io/mdexp/" title = "mdexp" -description = "Literate Programming with Embedded Snapshots" +description = "Literate programming with embedded snapshots" # The default language default_language = "en" diff --git a/doc/content/_index.md b/doc/content/_index.md index e16c41e..ca39e23 100644 --- a/doc/content/_index.md +++ b/doc/content/_index.md @@ -1,5 +1,5 @@ +++ -title = "mdexp — Literate Programming with Embedded Snapshots" +title = "Literate programming with embedded snapshots" template = "index.html" sort_by = "weight" +++ From fede8e4cbbcb31c4afdd2c1aa5a6d513511ea91f Mon Sep 17 00:00:00 2001 From: Mathieu Barbin Date: Mon, 11 May 2026 19:25:23 +0200 Subject: [PATCH 6/6] Fix removal step causing dune I/O errors on CI --- .github/workflows/ci.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index e4d4274..872c041 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -44,7 +44,6 @@ jobs: - name: Build and Run tests run: | - rm -rf _build/default/ mkdir $BISECT_DIR dune build @all @runtest --force --instrument-with bisect_ppx env: