doc: Render mermaid

effigies · effigies · commit fe6b41eccf37 · 2026-04-12T14:13:48.000-04:00
diff --git a/docs/conf.py b/docs/conf.py
@@ -14,6 +14,7 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions = [
+    'sphinxcontrib.mermaid',
     'myst_parser',
     'sphinx_copybutton',
     'sphinxext.rediraffe',
diff --git a/docs/dataset-lifecycle.md b/docs/dataset-lifecycle.md
@@ -14,7 +14,7 @@ pass through, and the mutations that drive transitions between them.
 A dataset's state is determined by two fields: whether it has any
 snapshots and whether it is public.
 
-```mermaid
+```{mermaid}
 stateDiagram-v2
     [*] --> Draft
     Draft --> Embargoed : createSnapshot()
@@ -126,7 +126,7 @@ delete.
 Snapshots can be independently deprecated without changing the dataset's
 state.
 
-```mermaid
+```{mermaid}
 stateDiagram-v2
     [*] --> Active : createSnapshot()
     Active --> Deprecated : deprecateSnapshot()
diff --git a/docs/index.md b/docs/index.md
@@ -90,6 +90,7 @@ structure of our package and hosting setup may be interested in the following se
 :maxdepth: 1
 
 architecture
+dataset-lifecycle
 maintenance
 Source repository (GitHub) <https://github.com/OpenNeuroOrg/openneuro>
 ```
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -4,3 +4,4 @@ myst-parser >=0.18.1
 sphinx-copybutton >=0.5.0
 pygments-graphql-lexer >=0.1.0
 sphinxext-rediraffe >=0.2.7
+sphinxcontrib-mermaid >=2.0.1
diff --git a/docs/specs/2026-04-06-doi-lifecycle-design.md b/docs/specs/2026-04-06-doi-lifecycle-design.md
