chore(docs): replace d2 diagram pipeline with mermaid

Remove docs/_diagrams/ and d2 build step from Makefile. The HTML
template already initialises mermaid.js; diagrams are now inline
code fences rendered client-side.
This commit is contained in:
pj committed 2026-04-23 00:05:44 +07:00
1 parent af7b7e27b0
commit 951a548109
2 files changed
+2 -73

No files matched your search

+2 -8
View File
@@ -14,8 +14,6 @@ SANDERLING_BIN := bin/sanderling
DOCS_SRC := $(shell find docs -type f -name '*.md' -not -path 'docs/_*')
DOCS_OUT := $(patsubst docs/%.md,build/site/%.html,$(DOCS_SRC))
DOCS_TEMPLATE := docs/_template/page.html
DIAGRAM_SRC := $(shell find docs/_diagrams -type f -name '*.d2' 2>/dev/null)
DIAGRAM_OUT := $(patsubst docs/_diagrams/%.d2,build/site/_assets/diagrams/%.svg,$(DIAGRAM_SRC))
INSPECT_DIST := internal/inspect/dist
WEB_DIST := inspect-ui/dist
@@ -84,18 +82,14 @@ test-kotlin:
test-spec-api:
cd pkg/spec && npm test --silent
docs: $(DOCS_OUT) build/site/_assets $(DIAGRAM_OUT)
@echo "built $(words $(DOCS_OUT)) pages, $(words $(DIAGRAM_OUT)) diagrams to build/site"
docs: $(DOCS_OUT) build/site/_assets
@echo "built $(words $(DOCS_OUT)) pages to build/site"
build/site/_assets: docs/_assets
@mkdir -p build/site
@rm -rf $@
@cp -R $< $@
build/site/_assets/diagrams/%.svg: docs/_diagrams/%.d2
@mkdir -p $(dir $@)
@d2 --theme 301 --pad 20 $< $@
build/site/%.html: docs/%.md $(DOCS_TEMPLATE)
@mkdir -p $(dir $@)
@pandoc $< --from=gfm --to=html5 --standalone \
-65
View File
@@ -1,65 +0,0 @@
grid-rows: 2
grid-gap: 40
test_run: {
label: "Test run"
grid-rows: 2
grid-gap: 100
go_binary: sanderling (Go) {
direction: right
bundler: Bundler\nesbuild
verifier: Verifier\ngoja + LTL
runner: Runner
driver: Driver
trace: Trace writer\nJSONL + PNG
bundler -> verifier
verifier <-> runner
runner -> driver
runner -> trace
}
platform: {
label: ""
direction: right
style.stroke-width: 0
style.fill: transparent
device: Emulator / device {
sdk: sanderling-sdk\npause / state\ncoverage / logs
}
sidecar: Maestro sidecar (JVM) {
maestro: maestro-client
}
sidecar.maestro -> device.sdk: UIAutomator
}
go_binary.driver -> platform.sidecar.maestro: gRPC
go_binary.runner -> platform.device.sdk: Unix socket
}
viewer: {
label: "Inspect"
grid-columns: 4
grid-gap: 40
left_pad: "" {
style.stroke-width: 0
style.fill: transparent
style.opacity: 0
}
web: Web UI (React)
inspect: sanderling inspect\nHTTP + SSE
runs: runs/ {
shape: cylinder
}
runs -> inspect
inspect -> web
}
test_run.go_binary.trace -> viewer.runs