diff --git a/doc/sphinx/reference/continuous-integration.md b/doc/sphinx/reference/continuous-integration.md
index e7f15a24735..41d4549ecc1 100644
--- a/doc/sphinx/reference/continuous-integration.md
+++ b/doc/sphinx/reference/continuous-integration.md
@@ -5,19 +5,10 @@ pipeline.
 
 ## Overview
 
-There are a number of components to this story:
-- Mir builds
-- unit, integration, acceptance and performance tests
-  - including our [WayLand Conformance Suite - WLCS](https://github.com/canonical/wlcs)
-- sanitizer runs
-- ABI checks
-- coverage measurement
-- `.deb` package builds
-- downstream Snap builds
-- end-to-end testing across different hardware
-  - test procedures maintained within [mir-ci](https://github.com/canonical/mir-ci)
-    and [checkbox-mir](https://github.com/canonical/checkbox-mir)
-  - automations defined in a private repository, as it includes infrastructure credentials
+There are a number of components to this story, and a diagram might make for a good overview:
+
+```{mermaid} continuous-integration.mmd
+```
 
 These are run at different stages in the pipeline, balancing the time it takes to run and the
 breadth of testing. We'll discuss those in more detail below.
diff --git a/doc/sphinx/reference/continuous-integration.mmd b/doc/sphinx/reference/continuous-integration.mmd
new file mode 100644
index 00000000000..7fc1d668dfe
--- /dev/null
+++ b/doc/sphinx/reference/continuous-integration.mmd
@@ -0,0 +1,16 @@
+flowchart TD
+    PR{{Pull Request}} --> Builds(<a href="#mir-builds">Builds and tests</a>
+                                  <a href="#unit-tests">unit</a>
+                                  <a href="#acceptance-tests">acceptance</a>
+                                  <a href="#integration-tests">integration</a>
+                                  <a href="#performance-and-smoke-tests">performance</a>)
+    PR --> Snaps(<a href="#downstream-snap-builds">Downstream snaps</a>)
+    PR --> ABI(<a href="#abi-checks">ABI checks</a>)
+    PR --> Coverage(<a href="#coverage-measurement">Coverage</a>)
+    Push{{Push}} --> Builds
+    Push --> Coverage
+    Push --> Sanitizers(<a href="#sanitizer-runs">Sanitizers</a>)
+    Push --> PPA(<a href="#deb-package-builds"><tt>.deb</tt> packages</a>)
+    PPA --> Snaps
+    Snaps --> EndToEnd(<a href="#end-to-end-testing">End-to-end testing</a>)
+